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 de 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 | Examine na direção à frente. Por exemplo, se o contêiner 5 for o contêiner verificado mais recentemente e pxcScan->cContainers for igual a dois, essa rotina retornará descritores para contêineres 6 e 7. |
| CLFS_SCAN_BACKWARD | Examine na direção anterior. Por exemplo, se o contêiner 5 for o contêiner verificado 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 de CLFS_SCAN_CLOSE estiver claro, apenas um dos sinalizadores de direção (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) deverá ser definido.
Valor de retorno
ClfsScanLogContainers retornará STATUS_SUCCESS se tiver êxito; caso contrário, ele retorna um dos códigos de erro definidos em Ntstatus.h.
Observações
O CLFS usa a estrutura CLFS_SCAN_CONTEXT para rastrear onde uma verificação de contêiner é iniciada (o membro do cIndex do) e quantos contêineres são verificados em cada chamada para ClfsScanLogContainers. O valor N do membro do cContainers especifica que sempre que ClfsScanLogContainers for chamado, os próximos N contêineres serão verificados.
O cContainersReturned membro 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 |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Server 2003 R2, Windows Vista e versões posteriores do Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| biblioteca | Clfs.lib |
| de DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |