通过

CreateTransactionManager 函数 （ktmw32.h）

  • 项目

创建新的事务管理器 （TM） 对象，并返回具有指定访问权限的句柄。

语法

HANDLE CreateTransactionManager(
  [in, optional] LPSECURITY_ATTRIBUTES lpTransactionAttributes,
  [in, optional] LPWSTR                LogFileName,
  [in, optional] ULONG                 CreateOptions,
  [in, optional] ULONG                 CommitStrength
);

参数

[in, optional] lpTransactionAttributes

TM 对象的事务 SECURITY_ATTRIBUTES（ACL）。

[in, optional] LogFileName

日志文件流名称。 如果日志中不存在流，则会创建该流。 若要创建可变 TM，此参数必须 NULL，CreateOptions 必须指定TRANSACTION_MANAGER_VOLATILE，此事务管理器被视为易失性。

[in, optional] CreateOptions

新 TM 的任何可选属性。

价值 意义
TRANSACTION_MANAGER_VOLATILE
 指示 TM 是可变的，并且不执行恢复。

[in, optional] CommitStrength

保留;指定零。

返回值

如果函数成功，则返回值是事务管理器的句柄。

如果函数失败，则返回值INVALID_HANDLE_VALUE。 若要获取扩展的错误信息，请调用 GetLastError 函数。

以下列表标识可能的错误代码：

言论

调用此函数后，必须立即调用 RecoverTransactionManager。

如果事务管理器是可变的，则所有资源管理器也必须是可变的。

创建 TM 后，必须调用 RecoverTransactionManager，以便 TM 正常工作。

要求

要求 价值
最低支持的客户端 Windows Vista
支持的最低服务器 Windows Server 2008
目标平台 窗户
标头 ktmw32.h
库 Ktmw32.lib
DLL Ktmw32.dll

另请参阅

内核事务管理器函数

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES