Compartilhar via


Função GetEnlistmentRecoveryInformation (ktmw32.h)

Recupera uma estrutura opaca de dados de recuperação do KTM. As informações de recuperação são armazenadas em um log em nome de um gerenciador de recursos (RM) chamando a função SetEnlistmentRecoveryInformation . Após uma falha, o RM pode usar a função GetEnlistmentRecoveryInformation para recuperar as informações.

Sintaxe

BOOL GetEnlistmentRecoveryInformation(
  [in]            HANDLE EnlistmentHandle,
  [in]            ULONG  BufferSize,
  [out]           PVOID  Buffer,
  [out, optional] PULONG BufferUsed
);

Parâmetros

[in] EnlistmentHandle

Um identificador para a inscrição.

[in] BufferSize

O tamanho do parâmetro Buffer , em bytes.

[out] Buffer

Um ponteiro para um buffer que recebe as informações de recuperação de inscrição.

[out, optional] BufferUsed

Um ponteiro para uma variável que recebe o número real de bytes retornados no parâmetro Buffer .

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 (0). Para obter informações de erro estendidas, chame a função GetLastError.

A lista a seguir identifica os possíveis códigos de erro:

Comentários

Essa chamada não pode ser usada com gerenciadores de transações voláteis.

Requisitos

   
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

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

SetEnlistmentRecoveryInformation