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