RegCreateKey函数创建指定的键。如果密钥已经存在于注册表中,则该函数将打开它。此函数用于与Windows 3.1版兼容。基于Win32的应用程序应使用RegCreateKeyEx功能。
LONG RegCreateKey(
HKEY 【的hKeyru-Latn】, | //处理一个开放的密钥 |
LPCTSTR 【lpSubKey】, | //要打开的子项名称的地址 |
PHKEY 【phkResultnl】 | //打开句柄缓冲区的地址 |
); |
参数
【的hKeyru-Latn】
标识当前打开的键或任何以下预定义保留句柄值:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
由此函数打开或创建的键是由【的hKeyru-Latn】标识的键的子键。
【lpSubKey】
指向一个以null结尾的字符串,指定此函数打开或创建的键的名称。该密钥必须是由【的hKeyru-Latn】参数标识的密钥的子密钥。
如果【的hKeyru-Latn】是预定义的键之一,【lpSubKey】可能为NULL。在这种情况下,使用【phkResultnl】返回的句柄与传递给函数的【的hKeyru-Latn】句柄相同。
【phkResultnl】
指向接收打开或创建的键的句柄的变量。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的一般描述。
备注
应用程序可以使用RegCreateKey功能一次创建多个键。例如,通过为【lpSubKey】参数指定以下格式的字符串,应用程序可以通过以下三个子项同时创建四个级别深度的子项:
【subkey2】\【subkey3】\【subkey4】\【The UDM_SETPOS message sets the current position for an up-down control.】
必须使用KEY_CREATE_SUB_KEY访问(KEY_WRITE访问包括KEY_CREATE_SUB_KEY访问)打开【的hKeyru-Latn】参数标识的密钥。
如果【lpSubKey】参数是空字符串的地址,则会打开该函数,然后返回由【的hKeyru-Latn】参数标识的键。【】
也可以看看
RegCloseKey, RegCreateKeyEx, RegDeleteKey, RegOpenKey, RegOpenKeyEx, RegSetValue