打开指定的注册表项。
注意 此函数仅用于与 16 位版本的 Windows 兼容。 应用程序应使用 RegOpenKeyEx 函数。
语法
LSTATUS RegOpenKeyA(
[in] HKEY hKey,
[in, optional] LPCSTR lpSubKey,
[out] PHKEY phkResult
);
参数
[in] hKey
打开的注册表项的句柄。 此句柄由 RegCreateKeyEx 或 RegOpenKeyEx 函数返回，也可以是以下 预定义键之一：
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
[in, optional] lpSubKey
要打开的注册表项的名称。 此键必须是由 hKey 参数标识的键的子项。
键名称不区分大小写。
如果此参数 NULL 或指向空字符串的指针，则该函数将返回传入的同一句柄。
有关详细信息，请参阅 注册表元素大小限制。
[out] phkResult
指向接收已打开键句柄的变量的指针。 如果密钥不是预定义的注册表项之一，请使用句柄后调用 RegCloseKey 函数。
返回值
如果函数成功，则返回值ERROR_SUCCESS。
如果函数失败，则返回值为 Winerror.h 中定义的非零错误代码。 可以将 FormatMessage 函数与FORMAT_MESSAGE_FROM_SYSTEM标志一起使用，以获取错误的泛型说明。
言论
RegOpenKey 函数使用默认的安全访问掩码打开密钥。 如果打开密钥需要其他访问权限，则函数会失败，返回ERROR_ACCESS_DENIED。 应用程序应使用 RegOpenKeyEx 函数在此情况下指定访问掩码。
RegOpenKey 如果数据库中不存在该键，则不会创建指定的键。
如果服务或应用程序模拟不同的用户，请不要将此函数用于 HKEY_CURRENT_USER。 而是调用 RegOpenCurrentUser 函数。
注意
winreg.h 标头将 RegOpenKey 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。
要求
要求
价值
最低支持的客户端
Windows 2000 Professional [仅限桌面应用]
支持的最低服务器
Windows 2000 Server [仅限桌面应用]
目标平台
窗户
标头
winreg.h （包括 Windows.h）
库
Advapi32.lib
DLL
Advapi32.dll
另请参阅
RegCloseKey
RegDeleteKey
RegOpenKeyEx
注册表函数
注册表概述