ZwDeleteKey 函式 (wdm.h)

  • 發行項

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

語法

NTSYSAPI NTSTATUS ZwDeleteKey(
  [in] HANDLE KeyHandle
);

參數

[in] KeyHandle

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

傳回值

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

  • STATUS_SUCCESS

  • STATUS_ACCESS_DENIED

  • STATUS_INVALID_HANDLE

  • STATUS_CANNOT_DELETE (請參閱)

備註

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

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

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

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

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

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。 如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱 使用 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