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