zwDeleteValueKey 函数 (wdm.h)

项目
03/08/2023

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或表示操作最终完成状态的相应错误状态。可能的错误状态代码包括：

返回代码	说明
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 Native System Services 例程的 NtXxx 和 ZwXxx 版本在处理和解释输入参数的方式上的行为可能有所不同。有关例程的 NtXxx 和 ZwXxx 版本之间的关系的详细信息，请参阅使用本机系统服务例程的 Nt 和 Zw 版本。

要求

要求	值
目标平台	通用
标头	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Fltkernel.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 符合性规则	HwStorPortProhibitedDDI (storport) ， PowerIrpDDis (wdm)