ZwOpenKey 函数 (wdm.h)

项目
02/29/2024

ZwOpenKey 例程打开现有注册表项。

语法

NTSYSAPI NTSTATUS ZwOpenKey(
  [out] PHANDLE            KeyHandle,
  [in]  ACCESS_MASK        DesiredAccess,
  [in]  POBJECT_ATTRIBUTES ObjectAttributes
);

参数

[out] KeyHandle

指向 HANDLE 变量的指针，该变量接收键的句柄。

[in] DesiredAccess

指定一个 ACCESS_MASK 值，该值确定对对象的请求访问权限。有关详细信息，请参阅 ZwCreateKey 的 DesiredAccess 参数。

[in] ObjectAttributes

指向 OBJECT_ATTRIBUTES 结构的指针，该结构指定对象名称和其他属性。使用 InitializeObjectAttributes 初始化此结构。如果调用方未在系统线程上下文中运行，则必须在调用 InitializeObjectAttributes 时设置 OBJ_KERNEL_HANDLE 属性。

返回值

如果打开给定密钥，ZwOpenKey 将返回STATUS_SUCCESS。否则，它可能会返回错误状态，包括以下内容：

STATUS_INVALID_HANDLE
STATUS_ACCESS_DENIED

注解

ZwOpenKey 提供调用方可用于操作注册表项的句柄。例程提供 ZwCreateKey 功能的子集。有关详细信息，请参阅在驱动程序中使用注册表。

如果指定的键不存在， ZwOpenKey 将返回错误状态，并且不返回键句柄。

不再使用 KeyHandle 指向的句柄后，驱动程序必须调用 ZwClose 来关闭它。

ZwOpenKey 忽略 ObjectAttributes 参数指向的结构中的安全信息。

如果调用方未在系统线程上下文中运行，则必须确保它创建的任何句柄都是专用句柄。否则，运行驱动程序的上下文中的进程可以访问句柄。有关详细信息，请参阅对象句柄。

有关使用注册表项的详细信息，请参阅在驱动程序中使用注册表。

如果在用户模式下调用此函数，则应使用名称“NtOpenKey”而不是“ZwOpenKey”。

要求

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