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 |