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

事务 SECURITY_ATTRIBUTES (TM 对象的 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
目标平台 Windows
标头 ktmw32.h
Library Ktmw32.lib
DLL Ktmw32.dll

另请参阅

内核事务管理器函数

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES