estructura CLS_SCAN_CONTEXT (clfs.h)

Artículo
03/16/2023

Contiene información sobre los contenedores examinados por ScanLogContainers, el tipo de examen que se está realizando y un cursor para realizar un seguimiento de los contenedores que se han examinado.

Sintaxis

typedef struct _CLS_SCAN_CONTEXT {
  CLFS_NODE_ID               cidNode;
  HANDLE                     hLog;
  ULONG                      cIndex;
  ULONG                      cContainers;
  ULONG                      cContainersReturned;
  CLFS_SCAN_MODE             eScanMode;
  PCLS_CONTAINER_INFORMATION pinfoContainer;
} CLS_SCAN_CONTEXT, *PCLS_SCAN_CONTEXT, PPCLS_SCAN_CONTEXT;

Miembros

cidNode

Identificador del nodo actual. Para obtener más información, consulte CLFS_NODE_ID.

hLog

Identificador del registro que se está examinando que se obtiene de CreateLogFile con permisos para examinar los contenedores de registro.

cIndex

Índice del contenedor actual.

cContainers

Número de estructuras de CLFS_CONTAINER_INFORMATION asignadas por el sistema en una matriz a la que apunta pinfoContainer.

Es decir, este miembro es el número de contenedores que se van a examinar con cada llamada de examen. El autor de la llamada sabe que el examen se completa cuando el número de contenedores devueltos es menor que este valor.

cContainersReturned

Número de contenedores que se devuelven después de una llamada a ScanLogContainers.

eScanMode

Modo en el que se examinan los contenedores.

Los contenedores se pueden examinar en uno de los modos siguientes.

Valor	Significado
CLFS_SCAN_INIT	Inicializa el contexto de examen, pero no asigna el almacenamiento asociado. La inicialización es destructiva, porque se pierden todos los datos almacenados en el contexto de examen actual.
CLFS_SCAN_CLOSE	Anula la inicialización del contexto de examen y desasigna el almacenamiento del sistema asociado a un contexto de examen.
CLFS_SCAN_FORWARD	Hace que la siguiente llamada a ScanLogContainers continúe en una dirección hacia delante. No se puede usar si se especifica CLFS_SCAN_BACKWARD .
CLFS_SCAN_BACKWARD	Hace que la siguiente llamada a ScanLogContainers continúe en una dirección hacia atrás. No se puede usar si se especifica CLFS_SCAN_FORWARD .

pinfoContainer

Puntero a una matriz asignada por el cliente de estructuras de CLFS_CONTAINER_INFORMATION que va a rellenar ScanLogContainers después de cada llamada correcta.