CLS_SCAN_CONTEXT struttura (clfs.h)

Articolo
02/23/2024

Contiene informazioni sui contenitori analizzati da ScanLogContainers, sul tipo di analisi eseguita e su un cursore per tenere traccia dei contenitori analizzati.

Sintassi

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;

Members

cidNode

ID del nodo corrente. Per altre informazioni, vedere CLFS_NODE_ID.

hLog

Handle per la scansione del log ottenuto da CreateLogFile con autorizzazioni per analizzare i contenitori di log.

cIndex

Indice del contenitore corrente.

cContainers

Numero di strutture CLFS_CONTAINER_INFORMATION allocato dal sistema in una matrice a cui punta pinfoContainer.

Questo membro è il numero di contenitori da analizzare con ogni chiamata di analisi. Il chiamante conosce il completamento dell'analisi quando il numero di contenitori restituiti è minore di questo valore.

cContainersReturned

Numero di contenitori restituiti dopo una chiamata a ScanLogContainers.

eScanMode

Modalità in cui vengono analizzati i contenitori.

È possibile analizzare i contenitori in una delle modalità seguenti.

Valore	Significato
CLFS_SCAN_INIT	Inizializza il contesto di analisi, ma non alloca l'archiviazione associata. L'inizializzazione è distruttiva, perché tutti i dati archiviati nel contesto di analisi corrente vengono persi.
CLFS_SCAN_CLOSE	Annulla l'inizializzazione del contesto di analisi e dealloca l'archiviazione di sistema associata a un contesto di analisi.
CLFS_SCAN_FORWARD	Determina che la chiamata successiva a ScanLogContainers procede in una direzione in avanti. Impossibile usare se è specificato CLFS_SCAN_BACKWARD .
CLFS_SCAN_BACKWARD	Determina che la chiamata successiva a ScanLogContainers procede in una direzione indietro. Impossibile usare se è specificato CLFS_SCAN_FORWARD .

pinfoContainer

Puntatore a una matrice allocata client di strutture CLFS_CONTAINER_INFORMATION da riempire da ScanLogContainers dopo ogni chiamata riuscita.

Commenti

Questa struttura viene allocata dal client, inizializzata usando CreateLogContainerScanContext e quindi passata a ScanLogContainers in chiamate ripetute.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 Build 20348
Server minimo supportato	Windows 10 Build 20348
Intestazione	clfs.h

Vedi anche

CLFS_CONTAINER_INFORMATION

CLFS_NODE_ID

ScanLogContainers

Condividi tramite