ZwOpenKey routine

ZwOpenKey routine

ZwOpenKey 例程打开一个已经存在的注册表键。

Syntax

 

NTSTATUS ZwOpenKey(

  _Out_ PHANDLE            KeyHandle,

  _In_  ACCESS_MASK        DesiredAccess,

  _In_  POBJECT_ATTRIBUTES ObjectAttributes

);

 

Parameters

KeyHandle [out]

指向一个HANDLE 变量的指针，此变量用于接收key的句柄。

DesiredAccess [in]

指定一个ACCESS_MASK，以决定请求访问对象的方式。更多详见ZwCreateKey的参数DesiredAccess;

ObjectAttributes [in]

指向OBJECT_ATTRIBUTES 结构体的指针，它指定了对象名和其他属性。使用InitializeObjectAttributes 初始化这个结构。若调用者不是在一个系统线程的上下文中运行，必须在InitializeObjectAttributes时设置OBJ_KERNEL_HANDLE属性。

Return value

ZwOpenKey 返回STATUS_SUCCESS 若打开了指定的键，否则返回一个如下的错误码：

STATUS_INVALID_HANDLE

STATUS_ACCESS_DENIED

Remarks

ZwOpenKey 提供一个句柄，调用者可以用它操作一个注册表键。此例程提供了ZwCreateKey的功能子集。更多信息见 Using the Registry in a Driver.

若指定键不存在, ZwOpenKey 返回一个错误码，并且不返回一个键的句柄。

一旦不再使用KeyHandle 指向的句柄, 驱动程序必须调用 ZwClose 关闭它。

ZwOpenKey 忽略在ObjectAttributes 参数指向的结构体中的安全信息成员。如果调用者没有运行在系统线程的上下文中，它必须保证任何它创建的句柄都是私有的句柄。否则句柄可能被其他运行在这个驱动上的进程上下文访问。更多详见 Object Handles.

更多关于使用注册表键的信息，见Using the Registry in a Driver.

Note   如果例程调用发生在用户模式，您应当使用"NtOpenKey" 代替 "ZwOpenKey".

 

Requirements

Target platform	Universal
Version	Available starting with Windows 2000.
Header	Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI compliance rules	IrqlZwPassive, PowerIrpDDis, ZwRegistryOpen, HwStorPortProhibitedDDIs, ZwRegistryCreate,ZwRegistryOpen(storport)

See also

ACCESS_MASK

InitializeObjectAttributes

ZwCreateKey

ZwDeleteKey

ZwEnumerateKey

ZwEnumerateValueKey

ZwFlushKey

ZwQueryKey

ZwQueryValueKey

ZwSetValueKey