RegOpenKey

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

RegOpenKey功能打开指定的键。此函数用于与Windows 3.1版兼容。基于Win32的应用程序应使用RegOpenKeyEx功能。

LONG RegOpenKey(

HKEY 【的hKeyru-Latn】,//打开密钥的句柄
LPCTSTR 【lpSubKey】,//要打开的子项名称的地址
PHKEY 【phkResultnl】//打开密钥的句柄地址
); 

参数

【的hKeyru-Latn】

标识当前打开的键或任何以下预定义保留句柄值:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

RegOpenKey功能打开的密钥是由【的hKeyru-Latn】标识的密钥的子项。

【lpSubKey】

指向一个以null结束的字符串,其中包含要打开的密钥的名称。该密钥必须是由【的hKeyru-Latn】参数标识的密钥的子密钥。如果此参数为NULL或指向空字符串的指针,则该函数将返回传入的相同句柄。

【phkResultnl】

指向接收打开的键的句柄的变量。

返回值

如果函数成功,则返回值为ERROR_SUCCESS。

如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的一般描述。

备注

RegOpenKey功能使用默认安全访问掩码来打开密钥。如果打开密钥需要不同的掩码,则该函数失败,返回ERROR_ACCESS_DENIED。在这种情况下,应用程序应使用RegOpenKeyEx功能来指定访问掩码。

RegCreateKey功能不同,如果数据库中不存在该键,则RegOpenKey不会创建指定的键。

也可以看看

RegCloseKey, RegCreateKey, RegCreateKeyEx, RegDeleteKey, RegOpenKeyEx