Função ClfsCreateScanContext (wdm.h)

A rotina 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 especificam 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 chamadores dessa rotina.

Valor	Significado
CLFS_SCAN_FORWARD	Configure o contexto de verificação para verificação na direção à frente. Por exemplo, se o contêiner 5 for o contêiner digitalizado mais recentemente e cContainers for 2, uma verificação de encaminhamento retornará descritores para os 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 anterior retornará descritores para os contêineres 4 e 3.
CLFS_SCAN_INIT	Reinicialize 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) deve ser definido.

[in, out] pcxScan

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

Retornar valor

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

Comentários

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)
Biblioteca	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Confira também

ClfsScanLogContainers