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

Weitere Informationen

Committransaction

CreateTransaction

Kerneltransaktions-Manager-Funktionen

RollbackTransaction

Transaktionszugriffsmasken