OpenTransaction-Funktion (ktmw32.h)

Artikel
08/24/2023

Ö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