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
記錄檔數據流名稱。 如果數據流不存在於記錄檔中,則會建立該數據流。 若要建立 volatile TM,此參數必須 NULL,而且 CreateOptions 必須指定TRANSACTION_MANAGER_VOLATILE,此交易管理員會被視為 volatile。
[in, optional] CreateOptions
新TM的任何選擇性屬性。
價值 | 意義 |
---|---|
|
表示TM是揮發性的,而且不會執行復原。 |
[in, optional] CommitStrength
保留;指定零。
傳回值
如果函式成功,傳回值就是交易管理員的句柄。
如果函式失敗,傳回值會INVALID_HANDLE_VALUE。 若要取得擴充的錯誤資訊,請呼叫 getLastError 函式
下列清單會識別可能的錯誤碼:
言論
在呼叫此函式之後,您必須呼叫 RecoverTransactionManager。
如果您的交易管理員是動態的,則所有資源管理員也必須是動態的。
您必須在建立TM之後呼叫 RecoverTransactionManager,才能讓TM正常運作。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
支援的最低伺服器 | Windows Server 2008 |
目標平臺 | 窗戶 |
標頭 | ktmw32.h |
連結庫 | Ktmw32.lib |
DLL | Ktmw32.dll |