ZwOpenKeyTransacted 函数 (wdm.h)
ZwOpenKeyTransacted 例程会打开现有的注册表项，并将该密钥与事务关联。
语法
NTSYSAPI NTSTATUS ZwOpenKeyTransacted(
[out] PHANDLE KeyHandle,
[in] ACCESS_MASK DesiredAccess,
[in] POBJECT_ATTRIBUTES ObjectAttributes,
[in] HANDLE TransactionHandle
);
参数
[out] KeyHandle
指向 HANDLE 变量的指针，例程在其中将句柄写入键。
[in] DesiredAccess
指定调用方请求的密钥的访问类型。 此参数是一个 ACCESS_MASK 值。 有关详细信息，请参阅 ZwCreateKey 例程的 DesiredAccess 参数的说明。
[in] ObjectAttributes
指向正在打开的键的对象属性的指针。 此参数指向之前必须由 InitializeObjectAttributes 例程初始化的OBJECT_ATTRIBUTES结构。 调用方必须在调用 InitializeObjectAttributes 时将注册表项的名称指定为 ObjectName 参数。 如果调用方未在系统线程上下文中运行，则必须在调用 InitializeObjectAttributes 时设置 OBJ_KERNEL_HANDLE 属性。
[in] TransactionHandle
事务对象的句柄。 若要获取此句柄，可以调用 ZwCreateTransaction 例程。 或者，如果具有指向事务对象的指针，则可以提供指向 ObOpenObjectByPointer 例程的指针以获取相应的事务句柄。
返回值
如果调用成功打开密钥，ZwOpenKeyTransacted 将返回STATUS_SUCCESS。 可能的错误返回值包括以下内容：
| 返回代码 | 说明 |
|---|---|
|
ObjectAttributes 参数为 NULL 或指向无效信息。 |
|
对象属性中的注册表路径无效。 |
|
找不到对象属性中的注册表路径。 |
|
调用方没有打开命名注册表项句柄所需的访问权限。 |
|
内存分配操作失败。 |
注解
此例程提供一个句柄，调用方可以使用该句柄访问注册表项。 此外，此例程将密钥与活动事务相关联。
不再使用 KeyHandle 指向的句柄后，驱动程序必须调用 ZwClose 例程来关闭它。
如果注册表中不存在指定的键， ZwOpenKeyTransacted 将返回错误状态值，并且不提供键句柄。 与 ZwCreateKeyTransacted 例程不同，如果该键不存在， ZwOpenKeyTransacted 例程不会创建指定的键。 ZwCreateKeyTransacted 和 ZwOpenKeyTransacted 将注册表项与事务相关联。
ZwOpenKey 例程类似于 ZwOpenKeyTransacted，但不将密钥与事务关联。
例如，在内核模式驱动程序获取事务 (句柄后，通过调用 ZwCreateTransaction) ，驱动程序可以执行一系列属于此事务的注册表操作。 驱动程序可以通过提交到事务中所做的更改或通过回滚事务来关闭事务。
驱动程序成功完成属于事务的所有注册表操作后，可以调用 ZwCommitTransaction 例程来提交更改。 驱动程序可以调用 ZwRollbackTransaction 例程来回滚事务。
在事务期间，如果执行该操作的系统调用满足以下任一条件，则注册表操作是事务的一部分：
- 调用指定事务句柄作为输入参数。 例如，对 ZwCreateKeyTransacted 和 ZwOpenKeyTransacted 的 调用可以将一个或多个密钥与事务相关联。
- 调用指定作为输入参数的注册表项句柄，该句柄是通过调用 ZwCreateKeyTransacted 或 ZwOpenKeyTransacted 获取的，该句柄提供事务句柄。 例如，对 ZwSetValueKey 例程的调用可以使用以这种方式获取的键句柄将注册表项的值设置为事务的一部分。
ZwOpenKeyTransacted 忽略 ObjectAttributes 参数指向的结构中的安全信息。
如果内核模式调用方未在系统线程上下文中运行，它必须确保它创建的任何句柄都是内核句柄。 否则，运行驱动程序的上下文的进程可以访问句柄。 有关详细信息，请参阅 对象句柄。
有关如何在内核模式下使用注册表项的详细信息，请参阅 在驱动程序中使用注册表。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 在 Windows Vista 和更高版本的 Windows 操作系统中可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI 符合性规则 | HwStorPortProhibitedDDI (storport) 、 PowerIrpDDis (wdm) |