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