Funzione GetTransactionInformation (ktmw32.h)

Restituisce le informazioni richieste sulla transazione specificata.

Sintassi

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
);

Parametri

[in] TransactionHandle

Handle per la transazione. L'handle deve disporre dell'autorizzazione TRANSACTION_QUERY_INFORMATION per recuperare le informazioni.

[out, optional] Outcome

Puntatore a un buffer che riceve il risultato corrente della transazione. Se la chiamata alla funzione GetTransactionInformation ha esito positivo, questo valore sarà uno dei valori di enumerazione TRANSACTION_OUTCOME .

[out, optional] IsolationLevel

Riservato.

[out, optional] IsolationFlags

Riservato.

[out, optional] Timeout

Puntatore a una variabile che riceve il valore di timeout, espresso in millisecondi, per questa transazione.

[in] BufferLength

Dimensioni del parametro Description , in byte. Il valore della lunghezza del buffer non può essere maggiore del valore di MAX_TRANSACTION_DESCRIPTION_LENGTH.

[out, optional] Description

Puntatore a un buffer che riceve la descrizione definita dall'utente della transazione.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni sull'errore estese, chiamare la funzione GetLastError .

L'elenco seguente identifica i possibili codici di errore:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista
Server minimo supportato Windows Server 2008
Piattaforma di destinazione Windows
Intestazione ktmw32.h
Libreria Ktmw32.lib
DLL Ktmw32.dll

Vedi anche

CreateTransaction

Funzioni di Gestione transazioni kernel

SetTransactionInformation