Função ReadLogArchiveMetadata (clfsw32.h)

Copia um intervalo da exibição de arquivo morto dos metadados para o buffer especificado.

Sintaxe

CLFSUSER_API BOOL ReadLogArchiveMetadata(
  [in]      CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
  [in]      ULONG                    cbOffset,
  [in]      ULONG                    cbBytesToRead,
  [in, out] PBYTE                    pbReadBuffer,
  [out]     PULONG                   pcbBytesRead
);

Parâmetros

[in] pvArchiveContext

Um ponteiro para um contexto de arquivo morto obtido por uma chamada para PrepareLogArchive.

O contexto mantém o estado do cursor, que permite a iteração por meio do conjunto de extensões de arquivo no arquivo morto. O cliente de arquivo morto é responsável por desalocar o contexto usando a função TerminateLogArchive .

[in] cbOffset

O deslocamento nos metadados em que a cópia de dados é iniciada.

Na primeira chamada para essa função, especifique zero (0). Em chamadas subsequentes, especifique o valor retornado em pcbBytesRead.

[in] cbBytesToRead

O número de bytes dos metadados instantâneo deve ser copiado para pbReadBuffer.

Esse parâmetro não pode ser zero (0).

[in, out] pbReadBuffer

Um ponteiro para o buffer em que os metadados instantâneo são copiados.

[out] pcbBytesRead

Um ponteiro para uma variável que recebe o número de bytes copiados para pbReadBuffer.

O número de bytes está sempre entre zero (0) e cbBytesToRead.

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á 0 (zero). Para obter informações de erro estendidas, chame GetLastError. A lista a seguir identifica os possíveis códigos de erro:

Requisitos

Confira também

Funções comuns do sistema de arquivos de log

PrepareLogArchive

TerminateLogArchive