NtOpenTransactionManager 函数 (wdm.h)

ZwOpenTransactionManager 例程获取现有事务管理器对象的句柄。

语法

__kernel_entry NTSYSCALLAPI NTSTATUS NtOpenTransactionManager(
  [out]          PHANDLE            TmHandle,
  [in]           ACCESS_MASK        DesiredAccess,
  [in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
  [in, optional] PUNICODE_STRING    LogFileName,
  [in, optional] LPGUID             TmIdentity,
  [in, optional] ULONG              OpenOptions
);

参数

[out] TmHandle

如果 ZwOpenTransactionManager 返回STATUS_SUCCESS,则指向调用方分配的变量的指针,该变量接收 事务管理器对象的句柄

[in] DesiredAccess

一个 ACCESS_MASK 值,该值指定调用方请求对事务管理器对象的访问。 有关如何指定此参数的信息,请参阅 ZwCreateTransactionManagerDesiredAccess 参数。

[in, optional] ObjectAttributes

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

[in, optional] LogFileName

指向 UNICODE_STRING 结构的指针,该结构包含创建事务管理器对象时创建的 日志文件流的路径和文件名。 有关详细信息,请参阅 ZwCreateTransactionManagerLogFileName 参数。 此参数是可选的,可以 NULL

[in, optional] TmIdentity

指向标识事务管理器对象的 GUID 的指针。 此参数是可选的,可以 NULL

[in, optional] OpenOptions

此参数未使用,且必须为零。

返回值

ZwOpenTransactionManager 如果作成功,则返回STATUS_SUCCESS。 否则,此例程可能会返回以下值之一:

返回代码 描述
STATUS_INVALID_PARAMETER
输入参数的值无效。
STATUS_INSUFFICIENT_RESOURCES
KTM 无法分配系统资源(通常是内存)。
STATUS_OBJECT_NAME_INVALID
ObjectAttributes 参数指定的对象名称无效。
STATUS_LOG_CORRUPTION_DETECTED
KTM 在创建或打开日志文件时遇到错误。
STATUS_ACCESS_DENIED
DesiredAccess 参数的值无效。
 

例程可能会 返回其他NTSTATUS 值。

言论

调用方可以使用以下三种方法之一来标识要打开的事务管理器对象:

  • 使用 LogFileName 参数指定创建事务管理器对象时创建的日志文件流的路径和文件名。
  • 使用 TmIdentity 参数指定标识事务管理器对象的 GUID。
  • 使用 ObjectAttributes 参数提供一个 OBJECT_ATTRIBUTES 结构,该结构包含以前指定给 ZwCreateTransactionManager 例程的调用方的对象名称。
必须仅指定上面列出的参数之一(对象名称、日志文件名或 GUID),并将其他两个参数设置为 NULL

TPS 组件在调用 ZwOpenTransactionManager后,必须调用 ZwRecoverTransactionManager

调用 ZwOpenTransactionManager 的 TPS 组件最终必须调用 ZwClose 才能关闭对象句柄。

有关如何使用 ZwOpenTransactionManager的详细信息,请参阅 事务管理器对象创建资源管理器

NtOpenTransactionManagerZwOpenTransactionManager 是同一 Windows 本机系统服务例程的两个版本。

对于内核模式驱动程序的调用,NtXxxZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxxZwXxx 例程之间的关系的详细信息,请参阅 使用 Nt 和 Zw 版本的本机系统服务例程

要求

要求 价值
最低支持的客户端 在 Windows Vista 和更高版本的作系统版本中可用。
目标平台 普遍
标头 wdm.h(包括 Wdm.h、Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI 符合性规则 HwStorPortProhibitedDDI、PowerIrpDDis

另请参阅

InitializeObjectAttributes

OBJECT_ATTRIBUTES

UNICODE_STRING

使用本机系统服务例程的 Nt 和 Zw 版本

ZwClose

ZwCreateTransactionManager

ZwQueryInformationTransactionManager