共用方式為


ZwDeleteKey 函式 (wdm.h)

ZwDeleteKey 例程會從登錄中刪除開啟的機碼。

語法

NTSYSAPI NTSTATUS ZwDeleteKey(
  [in] HANDLE KeyHandle
);

參數

[in] KeyHandle

要刪除之登錄機碼的句柄。 句柄是由成功呼叫 ZwCreateKeyZwOpenKey 所建立。

傳回值

ZwDeleteKey 會傳回 NTSTATUS 值。 可能的傳回值包括:

  • STATUS_SUCCESS

  • STATUS_ACCESS_DENIED

  • STATUS_INVALID_HANDLE

  • STATUS_CANNOT_DELETE (請參閱)

備註

呼叫 ZwDeleteKey 之前,請確定已刪除指定索引鍵下的所有索引鍵和值。 請先刪除每個子機碼,從分葉索引鍵開始,並正常運作。

必須開啟句柄,才能讓此例程成功存取 DELETE。 如需詳細資訊,請參閱 ZwCreateKeyDesiredAccess 參數。

呼叫 ZwDeleteKey 會導致 KeyHandle 參數中指定的句柄,以及已刪除密鑰的所有其他句柄變成無效。 呼叫 ZwDeleteKey 使金鑰句柄失效之後,您必須呼叫 ZwClose 以關閉金鑰句柄。

如需使用登錄機碼的詳細資訊,請參閱 在驅動程式中使用登錄

如果呼叫此函式發生在使用者模式中,您應該使用名稱 「NtDeleteKey」 而不是 「ZwDeleteKey」。

對於核心模式驅動程式的呼叫,Windows 原生系統服務例程的 NtXxxZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxxZwXxx 版本之間的關聯性詳細資訊,請參閱 使用 Nt 和 Zw 版本的原生系統服務例程

規格需求

需求
目標平台 Universal
標頭 wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 合規性規則 HwStorPortProhibitedDDIs (storport) IrqlZwPassive (wdm ) 、 PowerIrpDDis (wdm) ZwRegistryCreate (storport) 、ZwRegistryCreate (storport) 、 ZwRegistryCreate (wdm) ZwRegistryOpen (storport) 、 ZwRegistryOpen (storport ) 、 ZwRegistryOpen (wdm)

另請參閱

使用原生系統服務例程的 Nt 和 Zw 版本

ZwCreateKey

ZwOpenKey