Função ScanLogContainers (clfsw32.h)

Artigo
02/28/2024

Enumera contêineres de log. Chame essa função repetidamente para iterar em todos os contêineres de log.

Sintaxe

CLFSUSER_API BOOL ScanLogContainers(
  [in, out]           PCLFS_SCAN_CONTEXT pcxScan,
  [in]                CLFS_SCAN_MODE     eScanMode,
  [in, out, optional] LPVOID             pReserved
);

Parâmetros

[in, out] pcxScan

Um ponteiro para uma estrutura de CLFS_SCAN_CONTEXT alocada pelo cliente que a função CreateLogContainerScanContext inicializa.

[in] eScanMode

O modo para contêineres a serem verificados.

Os contêineres podem ser verificados em qualquer um dos seguintes modos de CLFS_SCAN_MODE .

Valor	Significado
CLFS_SCAN_INIT	Reinicializa o contexto de verificação, mas não aloca o armazenamento associado. A inicialização é destrutiva, pois todos os dados armazenados no contexto de verificação atual são perdidos.
CLFS_SCAN_CLOSE	Não inicializa o contexto de verificação e desaloca o armazenamento do sistema associado a um contexto de verificação.
CLFS_SCAN_FORWARD	Faz com que a próxima chamada para ScanLogContainers prossiga em direção à frente. Não será possível usar se CLFS_SCAN_BACKWARD for especificado.
CLFS_SCAN_BACKWARD	Faz com que a próxima chamada para ScanLogContainers prossiga na direção anterior. Não será possível usar se CLFS_SCAN_FORWARD for especificado.

[in, out, optional] pReserved

Reservado. Defina pReserved como NULL.

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.

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

Comentários

A ID de um contêiner de log é retornada em: pcxScan-pinfoContainer-LogicalContainerId>>.

Nota Os contextos de verificação do CLFS (Common Log File System) não são thread-safe. Eles não devem ser usados por mais de um thread por vez ou passados para mais de uma verificação assíncrona por vez.

Exemplos

Para obter um exemplo que usa essa função, consulte Enumerando contêineres de log.

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