RegCloseKey 函式 (winreg.h)
關閉指定登錄機碼的控制碼。
語法
LSTATUS RegCloseKey(
[in] HKEY hKey
);
參數
[in] hKey
要關閉之開啟索引鍵的控制碼。 控制碼必須由RegCreateKeyEx、RegCreateKeyTransacted、RegOpenKeyEx、RegOpenKeyTransacted或RegConnectRegistry 函式開啟。
傳回值
如果函式成功,傳回值會ERROR_SUCCESS。
如果函式失敗,傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來取得錯誤的泛型描述。
備註
指定的索引鍵控制碼不應該在關閉之後使用,因為它將不再有效。 金鑰控制碼不應保留開啟時間超過必要時間。
傳回之前 ,RegCloseKey 函式不一定會將資訊寫入登錄;快取排清到硬碟可能需要幾秒鐘的時間。 如果應用程式必須將登錄資訊明確寫入硬碟,則可以使用 RegFlushKey 函式。 不過,RegFlushKey會使用許多系統資源,而且只在必要時才應該呼叫。
範例
如需範例,請參閱 使用子機碼刪除金鑰。
規格需求
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winreg.h (包括 Windows.h) |
程式庫 | Advapi32.lib |
Dll | Advapi32.dll |