Compartilhar via


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

Confira também

Createtransaction

Funções do Gerenciador de Transações do Kernel

SetTransactionInformation