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 |
|---|---|
|
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 |