共用方式為


RegDeleteKeyA 函式 (winreg.h)

刪除子機碼及其值。 請注意,索引鍵名稱不區分大小寫。

64 位 Windows: 在 WOW64 上,32 位應用程式會檢視與 64 位應用程式檢視之登錄樹狀目錄不同的登錄樹狀結構。 若要讓應用程式刪除替代登錄檢視中的專案,請使用 RegDeleteKeyEx 函 式。

語法

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

參數

[in] hKey

開啟登錄機碼的控制碼。 此金鑰的存取權限不會影響刪除作業。 如需存取權限的詳細資訊,請參閱 登錄機碼安全性和存取權限

RegCreateKeyExRegOpenKeyEx函式會傳回此控制碼,或者它可以是下列其中一個預先定義的金鑰

HKEY_CLASSES_ROOT
HKEY_CURRENT_CONFIG
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS

[in] lpSubKey

要刪除的索引鍵名稱。 它必須是 hKey 所識別之索引鍵的子機碼,但不能有子機碼。 此參數不可為 Null

函式會以 DELETE 存取權限開啟子機碼。

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

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

傳回值

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

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

備註

在關閉最後一個控制碼之前,不會移除已刪除的索引鍵。

要刪除的子機碼不能有子機碼。 若要刪除索引鍵及其所有子機碼,您需要列舉子機碼並個別刪除它們。 若要以遞迴方式刪除索引鍵,請使用 RegDeleteTreeSHDeleteKey 函 式。

範例

如需使用此函式的範例,請參閱 使用子機碼刪除金鑰

注意

在舊版 Windows 上,此 API 也會由 kernel32.dll 公開。

注意

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

規格需求

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

另請參閱

RegCloseKey

RegCreateKeyEx

RegDeleteTree

RegOpenKeyEx

登錄函式

登錄概觀

SHDeleteEmptyKey

SHDeleteKey