Partager via


structure CLS_SCAN_CONTEXT (clfs.h)

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