Share via

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，此交易管理員會被視為變動性。

[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
程式庫 Ktmw32.lib
Dll Ktmw32.dll

另請參閱

核心交易管理員函式

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES