GetTransactionInformation-Funktion (ktmw32.h)
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 |