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

另請參閱

RegConnectRegistry

RegCreateKeyEx

RegDeleteKey

RegFlushKey

RegOpenKeyEx

登錄函式

登錄概觀