Função GetNextLogArchiveExtent (clfsw32.h)

  • Artigo

Recupera o próximo conjunto de extensões de arquivo morto em um contexto de arquivo morto de log. O contexto de arquivo de log descreve um conjunto contíguo de extensões de arquivo que abrangem o instantâneo do log ativo capturado pelas capturas PrepareLogArchive. GetNextLogArchiveExtent mantém um cursor no conjunto ordenado de descritores de arquivo de log para que as chamadas subsequentes permitam que um aplicativo itere por todo o conjunto.

Sintaxe

CLFSUSER_API BOOL GetNextLogArchiveExtent(
  [in]      CLFS_LOG_ARCHIVE_CONTEXT   pvArchiveContext,
  [in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
  [in]      ULONG                      cDescriptors,
  [out]     PULONG                     pcDescriptorsReturned
);

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, out] rgadExtent

Uma matriz alocada pelo cliente de CLFS_ARCHIVE_DESCRIPTOR estruturas a serem preenchidas por essa função.

[in] cDescriptors

O número de elementos na matriz rgadExtent .

Esse valor é o número máximo de descritores de arquivo morto que podem ser recuperados por essa função.

[out] pcDescriptorsReturned

O número de descritores na matriz rgadExtent que são preenchidos por essa função.

Se esse valor for menor que cDescriptors, o conjunto de descritores será esgotado e o cliente de arquivo morto poderá encerrar a iteração por meio do conjunto de descritores ordenados. Outras chamadas para essa função falham com ERROR_NO_MORE_ENTRIES.

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

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

Confira também

CLFS_ARCHIVE_DESCRIPTOR

Funções comuns do sistema de arquivos de log