RegUnLoadKeyA 函式 (winreg.h)

從登錄卸除指定的登錄機碼及其子機碼。

備份或還原系統狀態的應用程式，包括系統檔案和登錄區應該使用磁碟區陰影複製服務，而不是登錄功能。

語法

LSTATUS RegUnLoadKeyA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR lpSubKey
);

[in] hKey

要卸除之登錄機碼的句柄。此參數可以是呼叫 RegConnectRegistry 函式或下列其中一個預先定義句柄所傳回的句柄：

HKEY_LOCAL_MACHINEHKEY_USERS

[in, optional] lpSubKey

要卸除的子機碼名稱。 lpSubKey 參數所參考的金鑰必須使用 RegLoadKey 函式來建立。

索引鍵名稱不區分大小寫。

如需詳細資訊，請參閱登錄專案大小限制。

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標來取得錯誤的泛型描述。

此函式會從登錄中移除Hive，但不會修改包含登錄信息的檔案。 Hive 是位於登錄階層頂端的索引鍵、子機碼和值的離散主體。

呼叫進程必須具有登錄所在計算機上的SE_RESTORE_NAME和SE_BACKUP_NAME許可權。如需詳細資訊，請參閱使用特殊許可權執行。

注意

winreg.h 標頭會將 RegUnLoadKey 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。