RegOpenKeyEx()
函数功能描述:打开一个制定的注册表键
函数原型:
LONG RegOpenKeyEx(
HKEY hKey, // 已经打开键的句柄
LPCTSTR lpSubKey, // 子键的名称
DWORD ulOptions, // 保留
REGSAM samDesired, // 安全访问标记
PHKEY phkResult // 指向将要打开键的句柄
);
参数:
hKey
[输入] 当前打开或者以下预定义的键。
HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
Windows NT/2000/XP: HKEY_PERFORMANCE_DATA
Windows 95/98/Me: HKEY_DYN_DATA
lpSubKey
[输入] 指向一个非中断字符串包含将要打开键的名称。如果参数设置为NULL 或者指向一个空字符串，过程将打开一个新的句柄由hKey参数确定的值。这种情况下，过程不会关闭先前已经打开的句柄。
ulOptions
保留，必须设置为 0
samDesired
[输入] 对指定键希望得到的访问权限的访问标记。 这个参数可以使下列值的联合。
值 Meaning
KEY_CREATE_LINK 许可创建一个符号连接
KEY_CREATE_SUB_KEY 许可创建子键
KEY_ENUMERATE_SUB_KEYS 许可列举子键
KEY_EXECUTE 许可读访问
KEY_NOTIFY 许可提供更该通知
KEY_QUERY_VALUE 许可查询子键数据
KEY_SET_VALUE 许可设置子键数据
KEY_ALL_ACCESS 联合了 KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS,
KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK,
KEY_SET_VALUE 访问权限并且加上所有的标准访问权限
除了SYNCHRONIZE
KEY_READ 联合了 STANDARD_RIGHTS_READ, KEY_QUERY_VALUE,
KEY_ENUMERATE_SUB_KEYS,KEY_NOTIFY 访问权限
KEY_WOW64_64KEY Windows XP: 使64位或者32位应用程序打开64位键
KEY_WOW64_32KEY Windows XP: 使64位或者32位应用程序打开32位键
KEY_WRITE 联合 STANDARD_RIGHTS_WRITE, KEY_SET_VALUE,
KEY_CREATE_SUB_KEY访问权限
phkResult
[输出] 指向一个被打开键返回的句柄的指针。当不再需要句柄，必须调用 RegCloseKey 关闭它。
返回值:
如果过程执行成功，返回值是 ERROR_SUCCESS。
如果功能失败，返回一个非零值，错误码在 Winerror.h 定义。可以使用 FormatMessage 函数 和 FORMAT_MESSAGE_FROM_SYSTEM 标记获得一个分类的错误描述。
备注:
不像 RegCreateKeyEx 函数，当指定键不存在 RegOpenKeyEx 函数不创建新键。
Windows 95/98/Me: 注册表子键或值名称不能超过255字符。
Windows 95/98/Me: RegOpenKeyExW 被 Microsoft Layer for Unicode。 想要使用， 你必须在你的应用程序中包含某些文件。
示例代码:
//-- 转换基础键
HKEY GetBaseRegKey(char* keystr)
{
HKEY hKey;
if(strcmp(keystr,"HKEY_CLASSES_ROOT")==0)
hKey=HKEY_CLASSES_ROOT;
if(strcmp(keystr,"HKEY_CURRENT_CONFIG")==0)
hKey=HKEY_CURRENT_CONFIG;
if(strcmp(keystr,"HKEY_CURRENT_USER")==0)
hKey=HKEY_CURRENT_USER;
if(strcmp(keystr,"HKEY_LOCAL_MACHINE")==0)
hKey=HKEY_LOCAL_MACHINE;
if(strcmp(keystr,"HKEY_USERS")==0)
hKey=HKEY_USERS;
return hKey;
}
// 删除一个键值
int RegDelValue()
{
HKEY bKey,hKey;
LONG retVal;
char BaseKey[512];
char SubKey[512];
char SubKeyValueName[512];
strcpy(BaseKey,"HKEY_CURRENT_USER");
strcpy(SubKey,"Control Panel\Desktop");
strcpy(SubKeyValueName,"ShowMenuDelay");
bKey = GetBaseRegKey(BaseKey);
retVal = RegOpenKeyEx(bKey,SubKey,0,KEY_ALL_ACCESS,&hKey); //-- 打开子键
if (retVal != ERROR_SUCCESS)
{
return 1;
}
retVal = RegDeleteValue(hKey,(LPCTSTR)SubKeyValueName);
if(retVal !=ERROR_SUCCESS)
{
RegCloseKey(hKey);
return 2;
}
RegCloseKey(hKey);
return 0;
}
需求
Windows NT/2000/XP: 包含在 Windows NT 3.1 以后版本中。
Windows 95/98/Me: 包含在 Windows 95 以后版本中。
Header: Winreg.h; 包含在 Windows.h.
Library: 使用 Advapi32.lib.
Unicode: Unicode 和 ANSI 版本在 Windows NT/2000/XP 中支持，也被 Microsoft Layer for Unicode支持
相关函数
RegCloseKey RegSetValueEx
