GetTransactionInformation-Funktion (ktmw32.h)

  • Artikel

Gibt die angeforderten Informationen zur angegebenen Transaktion zurück.

Syntax

BOOL GetTransactionInformation(
  [in]            HANDLE TransactionHandle,
  [out, optional] PDWORD Outcome,
  [out, optional] PDWORD IsolationLevel,
  [out, optional] PDWORD IsolationFlags,
  [out, optional] PDWORD Timeout,
  [in]            DWORD  BufferLength,
  [out, optional] LPWSTR Description
);

Parameter

[in] TransactionHandle

Ein Handle für die Transaktion. Das Handle muss über die TRANSACTION_QUERY_INFORMATION Berechtigung zum Abrufen der Informationen verfügen.

[out, optional] Outcome

Ein Zeiger auf einen Puffer, der das aktuelle Ergebnis der Transaktion empfängt. Wenn der Aufruf der GetTransactionInformation-Funktion erfolgreich ist, ist dieser Wert einer der TRANSACTION_OUTCOME Enumerationswerte.

[out, optional] IsolationLevel

Reserviert.

[out, optional] IsolationFlags

Reserviert.

[out, optional] Timeout

Ein Zeiger auf eine Variable, die den Timeoutwert in Millisekunden für diese Transaktion empfängt.

[in] BufferLength

Die Größe des Description-Parameters in Bytes. Der Wert der Pufferlänge darf nicht länger als der Wert von MAX_TRANSACTION_DESCRIPTION_LENGTH sein.

[out, optional] Description

Ein Zeiger auf einen Puffer, der die benutzerdefinierte Beschreibung der Transaktion empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie die GetLastError-Funktion auf.

In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Anforderungen

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

CreateTransaction

Kerneltransaktions-Manager-Funktionen

SetTransactionInformation