Função GetTransactionInformation (ktmw32.h)
Retorna as informações solicitadas sobre a transação especificada.
Sintaxe
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
);
Parâmetros
[in] TransactionHandle
Um identificador para a transação. O identificador deve ter a permissão TRANSACTION_QUERY_INFORMATION para recuperar as informações.
[out, optional] Outcome
Um ponteiro para um buffer que recebe o resultado atual da transação. Se a chamada para a função GetTransactionInformation for bem-sucedida, esse valor será um dos valores de enumeração TRANSACTION_OUTCOME .
[out, optional] IsolationLevel
Reservado.
[out, optional] IsolationFlags
Reservado.
[out, optional] Timeout
Um ponteiro para uma variável que recebe o valor de tempo limite, em milissegundos, para essa transação.
[in] BufferLength
O tamanho do parâmetro Description , em bytes. O valor de comprimento do buffer não pode ser maior que o valor de MAX_TRANSACTION_DESCRIPTION_LENGTH.
[out, optional] Description
Um ponteiro para um buffer que recebe a descrição definida pelo usuário da transação.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame a função GetLastError.
A lista a seguir identifica os possíveis códigos de erro:
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | ktmw32.h |
| Biblioteca | Ktmw32.lib |
| DLL | Ktmw32.dll |