RegOpenKeyEx功能打开指定的键。
LONG RegOpenKeyEx(
HKEY 【的hKeyru-Latn】, | //打开密钥的句柄 |
LPCTSTR 【lpSubKey】, | //要打开的子项名称的地址 |
DWORD 【// security access mask】, | //保留 |
REGSAM 【Sndesired】, | //安全访问掩码 |
PHKEY 【phkResultnl】 | //打开密钥的句柄地址 |
); |
参数
【的hKeyru-Latn】
标识当前打开的键或任何以下预定义保留句柄值:
HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
【lpSubKey】
指向一个以null结束的字符串,其中包含要打开的子项的名称。如果此参数为NULL或指向空字符串的指针,则该函数将打开由【的hKeyru-Latn】参数标识的键的新句柄。在这种情况下,该函数不会关闭以前打开的句柄。
【// security access mask】
Reserved; must be zero.
【Sndesired】
指定一个访问掩码,描述新密钥所需的安全访问。此参数可以是以下值的组合:
值 | 含义 |
KEY_ALL_ACCESS | 组合KEY_QUERY_VALUE,KEY_ENUMERATE_SUB_KEYS,KEY_NOTIFY,KEY_CREATE_SUB_KEY,KEY_CREATE_LINK和KEY_SET_VALUE访问。 |
KEY_CREATE_LINK | 创建符号链接的权限。 |
KEY_CREATE_SUB_KEY | 创建子项的权限。 |
KEY_ENUMERATE_SUB_KEYS | 枚举子项的权限。 |
KEY_EXECUTE | 读访问权限 |
KEY_NOTIFY | 许可变更通知。 |
KEY_QUERY_VALUE | 查询子密钥数据的权限。 |
KEY_READ | 组合KEY_QUERY_VALUE,KEY_ENUMERATE_SUB_KEYS和KEY_NOTIFY访问。 |
KEY_SET_VALUE | 设置子密钥数据的权限。 |
KEY_WRITE | 组合KEY_SET_VALUE和KEY_CREATE_SUB_KEY访问。 |
【phkResultnl】
指向接收打开的键的句柄的变量。
返回值
如果函数成功,则返回值为ERROR_SUCCESS。
如果函数失败,返回值是在WINERROR.H中定义的非零错误代码。您可以使用带有FORMAT_MESSAGE_FROM_SYSTEM标志的FormatMessage函数来获取错误的通用描述。
备注
与RegCreateKeyEx功能不同,如果注册表中不存在该键,则RegOpenKeyEx功能不会创建指定的键。
也可以看看