Função ClfsCreateScanContext (wdm.h)

Artigo
02/07/2025

A rotina de ClfsCreateScanContext cria um contexto de verificação que pode ser usado para iterar nos contêineres de um log CLFS especificado.

Sintaxe

CLFSUSER_API NTSTATUS ClfsCreateScanContext(
  [in]      PLOG_FILE_OBJECT   plfoLog,
  [in]      ULONG              cFromContainer,
  [in]      ULONG              cContainers,
  [in]      CLFS_SCAN_MODE     eScanMode,
  [in, out] PCLFS_SCAN_CONTEXT pcxScan
);

Parâmetros

[in] plfoLog

Um ponteiro para uma estrutura LOG_FILE_OBJECT que representa um fluxo CLFS. O contexto de verificação é criado para o log que fornece o armazenamento subjacente para esse fluxo. O chamador obteve esse ponteiro anteriormente chamando ClfsCreateLogFile.

[in] cFromContainer

O índice do primeiro contêiner a ser verificado. Os contêineres são indexados a partir de zero.

[in] cContainers

O número de contêineres a serem verificados com cada chamada para ClfsScanLogContainers.

[in] eScanMode

Um conjunto de sinalizadores que especifica se o contexto de verificação está configurado para verificação para frente ou para trás e se o contexto de verificação deve ser reinicializado. Os três sinalizadores a seguir estão disponíveis para os chamadores dessa rotina.

Valor	Significado
CLFS_SCAN_FORWARD	Configure o contexto de verificação para verificação na direção de encaminhamento. Por exemplo, se o contêiner 5 for o contêiner verificado mais recentemente e cContainers for 2, uma verificação de encaminhamento retornará descritores para contêineres 6 e 7.
CLFS_SCAN_BACKWARD	Configure o contexto de verificação para verificação na direção anterior. Por exemplo, se o contêiner 5 for o contêiner verificado mais recentemente e cContainers for 2, uma verificação com versões anteriores retornará descritores para contêineres 4 e 3.
CLFS_SCAN_INIT	Reinicializar o contexto de verificação. Na próxima vez que ClfsScanLogContainers for chamado, ele se comportará como se estivesse sendo chamado pela primeira vez após a criação do contexto de verificação.

Se pcxScan apontar para uma estrutura CLFS_SCAN_CONTEXT que está sendo passada para essa rotina pela primeira vez, um dos sinalizadores de direção (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) deverá ser definido. O sinalizador CLFS_SCAN_INIT não deve ser definido.

Se pcxScan apontar para uma estrutura CLFS_SCAN_CONTEXT que foi passada para essa rotina anteriormente, o sinalizador CLFS_SCAN_INIT deverá ser definido. Além disso, um e apenas um dos sinalizadores de direção (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) devem ser definidos.

[in, out] pcxScan

Um ponteiro para uma estrutura de CLFS_SCAN_CONTEXT alocada por chamador cujos membros são inicializados por essa rotina. Essa estrutura é passada posteriormente para ClfsScanLogContainers.

Valor de retorno

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

Observações

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 (inclua Wdm.h)
biblioteca	Clfs.lib
de DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte também

ClfsScanLogContainers

Compartilhar via