Função ClfsScanLogContainers (wdm.h)

A rotina ClfsScanLogContainers recupera informações descritivas para uma sequência de contêineres que pertencem a um log CLFS específico.

Sintaxe

CLFSUSER_API NTSTATUS ClfsScanLogContainers(
  [in, out] PCLFS_SCAN_CONTEXT pcxScan,
  [in]      CLFS_SCAN_MODE     eScanMode
);

Parâmetros

[in, out] pcxScan

Um ponteiro para uma estrutura CLFS_SCAN_CONTEXT . O chamador alocou anteriormente a estrutura e a inicializou chamando ClfsCreateScanContext. Em particular, o membro pInfoContainer foi inicializado para apontar para uma matriz de estruturas CLFS_CONTAINER_INFORMATION e o membro cContainers foi inicializado para o número de elementos na matriz. No retorno, as estruturas na matriz recebem informações descritivas para os contêineres na sequência.

[in] eScanMode

Um conjunto de sinalizadores que especificam a direção da verificação e se o contexto de verificação deve ser fechado. Os sinalizadores a seguir estão disponíveis para os chamadores dessa rotina.

Valor	Significado
CLFS_SCAN_FORWARD	Verifique na direção para a frente. Por exemplo, se o contêiner 5 for o contêiner digitalizado mais recentemente e pxcScan->cContainers for igual a dois, essa rotina retornará descritores para contêineres 6 e 7.
CLFS_SCAN_BACKWARD	Verifique na direção anterior. Por exemplo, se o contêiner 5 for o contêiner digitalizado mais recentemente e pxcScan->cContainers for igual a dois, essa rotina retornará descritores para contêineres 4 e 3.
CLFS_SCAN_CLOSE	Libere todos os recursos associados ao contexto de verificação apontado por pcxScan.

 

Se o sinalizador de CLFS_SCAN_CLOSE estiver definido, os sinalizadores CLFS_SCAN_FORWARD e CLFS_SCAN_BACKWARD deverão estar claros.

Se o sinalizador CLFS_SCAN_CLOSE estiver claro, apenas um dos sinalizadores de direção (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) deverá ser definido.

Retornar valor

ClfsScanLogContainers retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retornará um dos códigos de erro definidos em Ntstatus.h.

Comentários

O CLFS usa a estrutura CLFS_SCAN_CONTEXT para rastrear onde uma verificação de contêiner é iniciada (o membro cIndex ) e quantos contêineres são verificados em cada chamada para ClfsScanLogContainers. O valor N do membro cContainers especifica que sempre que ClfsScanLogContainers for chamado, os próximos N contêineres serão verificados.

O membro cContainersReturned da estrutura CLFS_SCAN_CONTEXT recebe o número de contêineres realmente verificados em uma única chamada para ClfsScanLogContainers.

Quando ClfsScanLogContainers retorna STATUS_NO_MORE_ENTRIES, não há mais contêineres a serem verificados.

Quando terminar de usar o contexto de verificação apontado por pcxScan, você deverá chamar ClfsScanLogContainers, com eScanMode igual a CLFS_SCAN_CLOSE, para liberar todos os recursos associados ao contexto de verificação.

Para obter uma explicação dos conceitos e terminologia do CLFS, consulte Common Log File System.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows.
Plataforma de Destino	Área de Trabalho
Cabeçalho	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Biblioteca	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Confira também

CLFS_CONTAINER_INFORMATION

CLFS_SCAN_CONTEXT

ClfsCreateScanContext