RegCloseKey
SDK 函数:RegCloseKey
函数功能描述:释放指定注册键的句柄
函数原型
LONG RegCloseKey(
HKEY hKey // 释放键的句柄
);
参数
hKey : [输入] 想要关闭的已经打开的键。
返回值: 如果过程执行成功，返回值是 ERROR_SUCCESS。如果功能失败，返回一个非零值，错误码在 Winerror.h 定义。可以使用FormatMessage 函数和FORMAT_MESSAGE_FROM_SYSTEM 标记获得一个分类的错误描述。
备注: 被关闭的句柄将不可以再使用，应为已经不再有效。
RegCloseKey 函数在返回以前不能执行必要的写操作；它能够保持几秒钟为缓存执行写入磁盘，如果一个应用程序必须要写入注册表到硬盘，应该使用 RegFlushKey、RegFlushKey。.
示例代码：
//-- 转换基础键
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 CreateRegKey(PARAINFO painfo)
{
HKEY bKey;
HKEY hKey;
DWORD lpdwDisposition;
LONG retVal;
char BaseKey[512];
char SubKey[512];
int OpenState;
strcpy(BaseKey,painfo.BaseKey);
strcpy(SubKey,painfo.SubKey);
OpenState = painfo.RegState;
bKey = GetBaseRegKey(BaseKey);
retVal = RegCreateKeyEx( bKey,
SubKey,
NULL,
NULL,
REG_OPTION_NON_VOLATILE,
KEY_ALL_ACCESS,
NULL,
&hKey,
&lpdwDisposition);
if(retVal != ERROR_SUCCESS)
{
RegCloseKey(hKey); //-- 关闭句柄
return 1;
}
if(OpenState!= REG_STATE_OPEN)
{
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.
在VB中声明
Declare Function RegCloseKey Lib "advapi32.dll" Alias "RegCloseKey" (ByVal hKey As Long) As Long
说明
关闭系统注册表中的一个项（或键）
返回值
Long，零（ERROR_SUCCESS）表示成功。其他任何值都代表一个错误代码
参数表
参数 类型及说明
hKey Long，要关闭的项