structure CLS_SCAN_CONTEXT (clfs.h)

Article
02/23/2024

Contient des informations sur les conteneurs analysés par ScanLogContainers, le type d’analyse en cours d’exécution et un curseur pour suivre les conteneurs qui ont été analysés.

Syntaxe

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;

Membres

cidNode

ID du nœud actuel. Pour plus d’informations, consultez CLFS_NODE_ID.

hLog

Handle du journal en cours d’analyse qui est obtenu à partir de CreateLogFile avec des autorisations pour analyser les conteneurs de journaux.

cIndex

Index du conteneur actuel.

cContainers

Nombre de structures CLFS_CONTAINER_INFORMATION allouées par le système dans un tableau vers lequel pinfoContainer pointe.

Autrement dit, ce membre correspond au nombre de conteneurs à analyser à chaque appel d’analyse. L’appelant sait que l’analyse est terminée lorsque le nombre de conteneurs retournés est inférieur à cette valeur.

cContainersReturned

Nombre de conteneurs retournés après un appel à ScanLogContainers.

eScanMode

Mode dans lequel les conteneurs sont analysés.

Les conteneurs peuvent être analysés dans l’un des modes suivants.

Valeur	Signification
CLFS_SCAN_INIT	Initialise le contexte d’analyse, mais n’alloue pas de stockage associé. L’initialisation est destructrice, car toutes les données stockées dans le contexte d’analyse actuel sont perdues.
CLFS_SCAN_CLOSE	Annule la initialisation du contexte d’analyse et libère le stockage système associé à un contexte d’analyse.
CLFS_SCAN_FORWARD	Entraîne l’appel suivant à ScanLogContainers de se poursuivre dans une direction avant. Impossible d’utiliser si CLFS_SCAN_BACKWARD est spécifié.
CLFS_SCAN_BACKWARD	Entraîne le déroulement de l’appel suivant à ScanLogContainers vers l’arrière. Impossible d’utiliser si CLFS_SCAN_FORWARD est spécifié.

pinfoContainer

Un pointeur vers un tableau alloué par le client de CLFS_CONTAINER_INFORMATION structures à remplir par ScanLogContainers après chaque appel réussi.

Remarques

Cette structure est allouée par le client, initialisée à l’aide de CreateLogContainerScanContext, puis transmise à ScanLogContainers lors d’appels répétés .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 Build 20348
Serveur minimal pris en charge	Windows 10 Build 20348
En-tête	clfs.h

Voir aussi

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers

Partager via