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 的任何可选属性。
值 | 含义 |
---|---|
|
指示 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 |