ZwDeleteValueKey 函式 (wdm.h)

發行項
02/29/2024

ZwDeleteValueKey 例程會從登錄中的開啟機碼中刪除符合名稱的值專案。如果不存在這類專案，則會傳回錯誤。

語法

NTSYSAPI NTSTATUS ZwDeleteValueKey(
  [in] HANDLE          KeyHandle,
  [in] PUNICODE_STRING ValueName
);

參數

[in] KeyHandle

登錄機碼的句柄，其中包含感興趣的值專案。此金鑰必須已開啟，並已針對所需的存取設定KEY_SET_VALUE。此句柄是由成功呼叫 ZwCreateKey 或 ZwOpenKey 所建立。

[in] ValueName

包含要刪除之值項目名稱之UNICODE_STRING 結構的指標。如果值項目沒有名稱，這個參數可以是空字串。

傳回值

ZwDeleteValueKey 會傳回STATUS_SUCCESS或代表作業最終完成狀態的適當錯誤狀態。可能的錯誤狀態代碼包括：

傳回碼	Description
STATUS_ACCESS_DENIED	KeyHandle 句柄沒有KEY_SET_VALUE存取權。
STATUS_INSUFFICIENT_RESOURCES	此函式所需的其他資源無法使用。
STATUS_INVALID_HANDLE	指定的 KeyHandle 參數是 NULL 指標，或不是開啟登錄機碼的有效指標。
STATUS_OBJECT_NAME_NOT_FOUND	找不到 ValueName 登錄機碼專案。

備註

傳遞至 ZwDeleteValueKey 的 KeyHandle 必須已開啟，才能成功刪除存取權。 KEY_SET_VALUE、KEY_WRITE和 KEY_ALL_ACCESS 的 DesiredAccess 值包含刪除存取所需的KEY_SET_VALUE存取遮罩。如需 DesiredAccess 可能值的描述，請參閱 ZwCreateKey。

如果為此登錄機碼註冊回呼函式，則會呼叫這些回呼函式。

設備驅動器不應該嘗試直接呼叫 ZwDeleteValueKey ，以刪除 \Registry 子機碼中的值專案 。\ResourceMap 機碼。只有系統可以寫入或刪除 \Registry 中的值專案 。\HardwareDescription 樹狀結構。

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

針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱使用原生系統服務例程的 Nt 和 Zw 版本。

規格需求

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