OpenTransaction-Funktion (ktmw32.h)
Öffnet eine vorhandene Transaktion.
Syntax
HANDLE OpenTransaction(
[in] DWORD dwDesiredAccess,
[in] LPGUID TransactionId
);
Parameter
[in] dwDesiredAccess
Der Zugriff auf das Transaktionsobjekt. Sie benötigen Lese- und Schreibzugriff, um mit einer Transaktion arbeiten zu können. Eine Liste der gültigen Werte finden Sie unter Transaktionszugriffsmasken .
[in] TransactionId
Die GUID, die die zu öffnende Transaktion identifiziert. Dies wird häufig als Arbeitseinheit für die Transaktion bezeichnet.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Transaktion.
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
Clients schließen das Transaktionshandle mithilfe der CloseHandle-Funktion . Wenn das letzte Transaktionshandle geschlossen wird, ohne dass jemand die CommitTransaction-Funktion für die Transaktion aufruft, führt die KTM implizit ein Rollback für die Transaktion aus.
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 |