共用方式為


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 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winreg.h (包括 Windows.h)
程式庫 Advapi32.lib
Dll Advapi32.dll

另請參閱

RegConnectRegistry

RegDeleteKey

RegLoadKey

RegRestoreKey

登錄函式

登錄概觀