Función ClfsCreateScanContext (wdm.h)

La rutina ClfsCreateScanContext crea un contexto de examen que se puede usar para iterar en los contenedores de un registro CLFS especificado.

Sintaxis

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

Puntero a una estructura LOG_FILE_OBJECT que representa una secuencia CLFS. El contexto de examen se crea para el registro que proporciona el almacenamiento subyacente para esa secuencia. El autor de la llamada obtuvo previamente este puntero mediante una llamada a ClfsCreateLogFile.

[in] cFromContainer

Índice del primer contenedor que se va a examinar. Los contenedores se indexan a partir de cero.

[in] cContainers

Número de contenedores que se van a examinar con cada llamada a ClfsScanLogContainers.

[in] eScanMode

Conjunto de marcas que especifican si el contexto de examen está configurado para examinar hacia delante o hacia atrás y si se debe reinicializar el contexto del examen. Las tres marcas siguientes están disponibles para los autores de llamadas de esta rutina.

Valor	Significado
CLFS_SCAN_FORWARD	Configure el contexto de examen para examinar en la dirección hacia delante. Por ejemplo, si el contenedor 5 es el contenedor examinado más recientemente y cContainers es 2, un examen hacia delante devolvería descriptores para los contenedores 6 y 7.
CLFS_SCAN_BACKWARD	Configure el contexto de examen para examinar en la dirección hacia atrás. Por ejemplo, si el contenedor 5 es el contenedor examinado más recientemente y cContainers es 2, un examen hacia atrás devolvería descriptores para los contenedores 4 y 3.
CLFS_SCAN_INIT	Reinicializar el contexto de examen. La próxima vez que se llame a ClfsScanLogContainers , se comportará como si se llamara por primera vez después de la creación del contexto de examen.

 

Si pcxScan apunta a una estructura de CLFS_SCAN_CONTEXT que se pasa a esta rutina por primera vez, se debe establecer una de las marcas de dirección (CLFS_SCAN_FORWARD o CLFS_SCAN_BACKWARD). No se debe establecer la marca CLFS_SCAN_INIT.

Si pcxScan apunta a una estructura de CLFS_SCAN_CONTEXT que se ha pasado previamente a esta rutina, se debe establecer la marca CLFS_SCAN_INIT. Además, se debe establecer una y solo una de las marcas de dirección (CLFS_SCAN_FORWARD o CLFS_SCAN_BACKWARD).

[in, out] pcxScan

Puntero a una estructura de CLFS_SCAN_CONTEXT asignada por el autor de la llamada cuyos miembros se inicializan mediante esta rutina. Esta estructura se pasa posteriormente a ClfsScanLogContainers.

Valor devuelto

ClfsCreateScanContext devuelve STATUS_SUCCESS si se realiza correctamente; de lo contrario, devuelve uno de los códigos de error en Ntstatus.h.

Comentarios

Para obtener una explicación de los conceptos y la terminología de CLFS, consulte Common Log File System.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible en Windows Server 2003 R2, Windows Vista y versiones posteriores de Windows.
Plataforma de destino	Escritorio
Encabezado	wdm.h (incluya Wdm.h)
Library	Clfs.lib
Archivo DLL	Clfs.sys
IRQL	<= APC_LEVEL

Consulte también

ClfsScanLogContainers