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 值,该值指定调用方请求对事务管理器对象的访问。 有关如何指定此参数的信息,请参阅 ZwCreateTransactionManager的 DesiredAccess 参数。
[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。 否则,此例程可能会返回以下值之一:
返回代码 | 描述 |
---|---|
|
输入参数的值无效。 |
|
KTM 无法分配系统资源(通常是内存)。 |
|
ObjectAttributes 参数指定的对象名称无效。 |
|
KTM 在创建或打开日志文件时遇到错误。 |
|
DesiredAccess 参数的值无效。 |
例程可能会 返回其他NTSTATUS 值。
调用方可以使用以下三种方法之一来标识要打开的事务管理器对象:
- 使用 LogFileName 参数指定创建事务管理器对象时创建的日志文件流的路径和文件名。
- 使用 TmIdentity 参数指定标识事务管理器对象的 GUID。
- 使用 ObjectAttributes 参数提供一个 OBJECT_ATTRIBUTES 结构,该结构包含以前指定给 ZwCreateTransactionManager 例程的调用方的对象名称。
TPS 组件在调用 ZwOpenTransactionManager后,必须调用 ZwRecoverTransactionManager。
调用 ZwOpenTransactionManager 的 TPS 组件最终必须调用 ZwClose 才能关闭对象句柄。
有关如何使用 ZwOpenTransactionManager的详细信息,请参阅 事务管理器对象 和 创建资源管理器。
NtOpenTransactionManager 和 ZwOpenTransactionManager 是同一 Windows 本机系统服务例程的两个版本。
对于内核模式驱动程序的调用,NtXxx 和 ZwXxx 版本的 Windows 本机系统服务例程的行为方式可能以不同的方式处理和解释输入参数。 有关 NtXxx 与 ZwXxx 例程之间的关系的详细信息,请参阅 使用 Nt 和 Zw 版本的本机系统服务例程。
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Windows Vista 和更高版本的作系统版本中可用。 |
目标平台 | 普遍 |
标头 | wdm.h(包括 Wdm.h、Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |
DDI 符合性规则 | HwStorPortProhibitedDDI、PowerIrpDDis |