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

Vedi anche

CreateTransaction

Funzioni di Gestione transazioni kernel

SetTransactionInformation