NtCreateTransactionManager 函数 （wdm.h）
ZwCreateTransactionManager 例程创建新的事务管理器对象。
语法
__kernel_entry NTSYSCALLAPI NTSTATUS NtCreateTransactionManager(
[out] PHANDLE TmHandle,
[in] ACCESS_MASK DesiredAccess,
[in, optional] POBJECT_ATTRIBUTES ObjectAttributes,
[in, optional] PUNICODE_STRING LogFileName,
[in, optional] ULONG CreateOptions,
[in, optional] ULONG CommitStrength
);
参数
[out] TmHandle
指向调用方分配的变量的指针，该变量接收新 事务管理器对象的句柄。
[in] DesiredAccess
一个 ACCESS_MASK 值，该值指定调用方请求对事务管理器对象的访问。 除了为各种对象定义的访问权限（请参阅 ACCESS_MASK），调用方还可以为事务管理器对象指定以下任一访问权限标志。
| ACCESS_MASK标志 | 允许调用方 |
|---|---|
| TRANSACTIONMANAGER_CREATE_RM | 创建资源管理器（请参阅 ZwCreateResourceManager）。 |
| TRANSACTIONMANAGER_QUERY_INFORMATION | 获取有关事务管理器的信息（请参阅 ZwQueryInformationTransactionManager 和 ZwEnumerateTransactionObject）。 ZwOpenResourceManager、ZwCreateTransaction和 ZwOpenTransaction也需要 。 |
| TRANSACTIONMANAGER_RECOVER | 恢复事务管理器（请参阅 ZwRecoverTransactionManager 和 ZwRollforwardTransactionManager）。 |
| TRANSACTIONMANAGER_RENAME | 未使用。 |
| TRANSACTIONMANAGER_SET_INFORMATION | 未使用。 |
或者，可以指定以下一个或多个 ACCESS_MASK 位图。 这些位图将上表中的标志与STANDARD_RIGHTS_XXX 标志组合在 ACCESS_MASK 参考页上。 还可以将这些位图与上表中的其他标志组合在一起。 下表显示了位图如何对应于特定的访问权限。
| Rights bitmap | 特定访问权限集 |
|---|---|
| TRANSACTIONMANAGER_GENERIC_READ | STANDARD_RIGHTS_READ和TRANSACTIONMANAGER_QUERY_INFORMATION |
| TRANSACTIONMANAGER_GENERIC_WRITE | STANDARD_RIGHTS_WRITE、TRANSACTIONMANAGER_SET_INFORMATION、TRANSACTIONMANAGER_RECOVER、TRANSACTIONMANAGER_RENAME和TRANSACTIONMANAGER_CREATE_RM |
| TRANSACTIONMANAGER_GENERIC_EXECUTE | STANDARD_RIGHTS_EXECUTE |
| TRANSACTIONMANAGER_ALL_ACCESS | STANDARD_RIGHTS_REQUIRED、TRANSACTIONMANAGER_GENERIC_READ、TRANSACTIONMANAGER_GENERIC_WRITE 和TRANSACTIONMANAGER_GENERIC_EXECUTE |
[in, optional] ObjectAttributes
指向指定对象名称和其他属性的 OBJECT_ATTRIBUTES 结构的指针。 使用 InitializeObjectAttributes 例程初始化此结构。 如果调用方未在系统线程上下文中运行，则必须在调用 InitializeObjectAttributes时设置OBJ_KERNEL_HANDLE属性。 此参数是可选的，可以 NULL。
[in, optional] LogFileName
指向 UNICODE_STRING 结构的指针，该结构包含与事务管理器对象关联的 CLFS 日志文件流的路径和文件名。 如果 TRANSACTION_MANAGER_VOLATILE CreateOptions 参数，则必须 NULL 此参数。 否则，此参数必须是非NULL。 有关详细信息，请参阅以下“备注”部分。
[in, optional] CreateOptions
可选对象创建标志。 下表包含可用标志，这些标志在 Ktmtypes.h 中定义。
| 选项标志 | 意义 |
|---|---|
| TRANSACTION_MANAGER_VOLATILE | 事务管理器对象将是可变的。 因此，它不会使用日志文件。 |
| TRANSACTION_MANAGER_COMMIT_DEFAULT | 仅供内部使用。 |
| TRANSACTION_MANAGER_COMMIT_SYSTEM_VOLUME | 仅供内部使用。 |
| TRANSACTION_MANAGER_COMMIT_SYSTEM_HIVES | 仅供内部使用。 |
| TRANSACTION_MANAGER_COMMIT_LOWEST | 仅供内部使用。 |
| TRANSACTION_MANAGER_CORRUPT_FOR_RECOVERY | 仅供内部使用。 |
| TRANSACTION_MANAGER_CORRUPT_FOR_PROGRESS | 仅供内部使用。 |
[in, optional] CommitStrength
保留以供将来使用。 此参数必须为零。
返回值
ZwCreateTransactionManager 如果作成功，则返回STATUS_SUCCESS。 否则，此例程可能会返回以下值之一：
| 返回代码 | 描述 |
|---|---|
|
输入参数的值无效。 |
|
KTM 无法分配系统资源（通常是内存）。 |
|
KTM 在创建或打开日志文件时遇到错误。 |
|
安全描述符包含无效的访问控制列表（ACL）。 |
|
安全描述符包含无效的安全标识符（SID）。 |
|
ObjectAttributes 参数指定的对象名称已存在。 |
|
作系统检测到重复的对象名称。 此错误可能指示日志流已被使用。 |
|
ObjectAttributes 参数指定的对象名称无效。 |
|
DesiredAccess 参数的值无效。 |
例程可能会 返回其他NTSTATUS 值。
言论
如果 LogFileName 参数指定的日志文件流不存在，则 KTM 调用 CLFS 来创建流。 如果该流已存在，KTM 会调用 CLFS 以打开流。
TPS 组件在调用 ZwCreateTransactionManager 后，必须调用 ZwRecoverTransactionManager
如果 TPS 组件在 CreateOptions 参数中指定TRANSACTION_MANAGER_VOLATILE标志，则与事务管理器对象关联的所有资源管理器必须在调用 ZwCreateResourceManager时指定RESOURCE_MANAGER_VOLATILE标志。
调用 ZwCreateTransactionManager 的 TPS 组件最终必须调用 ZwClose 才能关闭对象句柄。
有关如何使用 ZwCreateTransactionManager的详细信息，请参阅 创建资源管理器。
NtCreateTransactionManager 和 ZwCreateTransactionManager 是同一 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 |