CreateTransactionManager-Funktion (ktmw32.h)

  • Artikel

Erstellt ein neues Transaktions-Manager-Objekt (TM) und gibt ein Handle mit dem angegebenen Zugriff zurück.

Syntax

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

Parameter

[in, optional] lpTransactionAttributes

Die Transaktion SECURITY_ATTRIBUTES (ACLs) für das TM-Objekt.

[in, optional] LogFileName

Der Name des Protokolldateistreams. Wenn der Stream nicht im Protokoll vorhanden ist, wird er erstellt. Um einen flüchtigen TM zu erstellen, muss dieser Parameter NULL sein, und CreateOptions muss angeben, TRANSACTION_MANAGER_VOLATILE dieser Transaktions-Manager als volatil gilt.

[in, optional] CreateOptions

Alle optionalen Attribute für die neue TM.

Wert Bedeutung
TRANSACTION_MANAGER_VOLATILE
 Gibt an, dass der TM volatil ist und keine Wiederherstellung durchführt.

[in, optional] CommitStrength

Reserviert; geben Sie null an.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Transaktions-Manager.

Wenn die Funktion fehlschlägt, ist der Rückgabewert INVALID_HANDLE_VALUE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Hinweise

Unmittelbar nach dem Aufrufen dieser Funktion müssen Sie RecoverTransactionManager aufrufen.

Wenn Ihr Transaktions-Manager volatil ist, müssen alle Ressourcenmanager ebenfalls volatil sein.

Sie müssen RecoverTransactionManager aufrufen, nachdem Sie ein TM erstellt haben, damit der TM ordnungsgemäß funktioniert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista
Unterstützte Mindestversion (Server) Windows Server 2008
Zielplattform Windows
Kopfzeile ktmw32.h
Bibliothek Ktmw32.lib
DLL Ktmw32.dll

Weitere Informationen

Kerneltransaktions-Manager-Funktionen

OpenTransactionManager

RecoverTransactionManager

SECURITY_ATTRIBUTES