Função TxfLogReadRecords (txfw32.h)

Artigo
03/03/2024

[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do aplicativo. Muitos cenários para os quais o TxF foi desenvolvido podem ser obtidos por meio de técnicas mais simples e prontamente disponíveis. Além disso, o TxF pode não estar disponível em versões futuras do Microsoft Windows. Para obter mais informações e alternativas ao TxF, confira Alternativas ao uso do NTFS transacional.]

Lê os registros de restauração do log.

Sintaxe

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

Parâmetros

[in] TxfLogContext

Um ponteiro para o contexto.

[in] BufferLength

O tamanho do buffer de saída em bytes.

[out] Buffer

Um ponteiro para o buffer que recebe os registros. Para obter mais informações, consulte TXF_LOG_RECORD_BASE.

[out] BytesUsed

O número de bytes gravados no buffer de saída.

[out] RecordCount

O número de registros gravados no buffer de saída.

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 GetLastError. Os códigos de erro possíveis incluem o seguinte.

Código de retorno	Descrição
ERROR_INVALID_HANDLE	O contexto de replicação é inválido.
ERROR_MORE_DATA	Alguns dos registros disponíveis foram copiados para o buffer. Chame essa função novamente para recuperar o restante dos registros.
ERROR_INSUFFICIENT_BUFFER	O buffer não é grande o suficiente para conter até mesmo um registro. Se BytesUsed não for zero, haverá espaço suficiente para copiar a estrutura TXF_LOG_RECORD_BASE , o que indica o tamanho do buffer necessário para ler o próximo registro completo.
ERROR_FILE_CORRUPT	O formato do arquivo de log que está sendo processado não é reconhecido.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista com SP1 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	txfw32.h
Biblioteca	TxfW32.lib
DLL	TxfW32.dll

Confira também

TXF_LOG_RECORD_BASE