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) |