CreateTransactionManager-Funktion (ktmw32.h)

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 Protokolldateidatenstroms. Wenn der Datenstrom nicht im Protokoll vorhanden ist, wird er erstellt. Um eine veränderliche TM zu erstellen, muss dieser Parameter NULL- sein, und CreateOptions- muss TRANSACTION_MANAGER_VOLATILE angeben, wird dieser Transaktionsmanager als veränderlich betrachtet.

[in, optional] CreateOptions

Alle optionalen Attribute für die neue TM.

Wert	Bedeutung
TRANSACTION_MANAGER_VOLATILE	Gibt an, dass die TM veränderlich 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 Transaktionsmanager.

Wenn die Funktion fehlschlägt, wird der Rückgabewert INVALID_HANDLE_VALUE. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die GetLastError--Funktion auf.

Die folgende Liste identifiziert die möglichen Fehlercodes:

Bemerkungen

Unmittelbar nach dem Aufrufen dieser Funktion müssen Sie RecoverTransactionManageraufrufen.

Wenn Ihr Transaktionsmanager veränderlich ist, müssen alle Ressourcenmanager ebenfalls veränderlich sein.

Sie müssen RecoverTransactionManager- aufrufen, nachdem Sie eine TM erstellt haben, damit die TM ordnungsgemäß funktioniert.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	ktmw32.h
Library	Ktmw32.lib
DLL-	Ktmw32.dll

Siehe auch

Kernel Transaction Manager Functions

OpenTransactionManager-

RecoverTransactionManager-

SECURITY_ATTRIBUTES