RegCreateKey

【勇芳软件工作室】汉化HomePreviousNext

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