RegCloseKey
(更多请见http://websl.126.com)
RegCloseKey函数释放给定键的句柄。
LONG RegCloseKey(
HKEY hKey // 要关闭键的句柄
);
参数
-
hKey
- 要关闭已打开键的句柄。
返回值
如果调用成功,返回ERROR_SUCCESS。
如果调用失败,返回非零错误代码(定义在WINERROR.H)。你可以使用带有FORMAT_MESSAGE_FROM_SYSTE标记 FormatMessage函数获得普通错误描述信息。
注意
这个给定键的句柄不应该在它关闭后使用,因为它不再有效。键句柄不应该比需要的时间短。
RegCloseKey在返回之前不需要往注册表中写信息;它可以花费几秒缓存到硬盘的缓存区。如果一个应用程序必须明确的写注册信息到硬盘,它可以使用RegFlushKey函数。RegFlushKey,然而使用了更多的系统资源,应该在必需时才调用它。
Windows CE: RegCloseKey函数总是在返回前写信息到注册表,在Windows CE去除了缓存键的需要。
快速信息
Windows NT: 需要3.1或更高版本。
Windows: 需要Windows 95或更高版本。
Windows CE: 需要1.0或更高版本。
头文件: winreg.h。
输入库: advapi32.lib。
参见
Registry Overview, Registry Functions, RegCreateKey, RegCreateKeyEx, RegDeleteKey, RegFlushKey, RegOpenKey, RegOpenKeyEx, RegSetValue, RegSetValueEx