Função GetNextLogArchiveExtent (clfsw32.h)
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 |