Win32 SDK注册表操作——RegCloseKey

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