Funzione ScanLogContainers (clfsw32.h)

Articolo
03/05/2024

Enumera i contenitori di log. Chiamare ripetutamente questa funzione per eseguire l'iterazione su tutti i contenitori di log.

Sintassi

CLFSUSER_API BOOL ScanLogContainers(
  [in, out]           PCLFS_SCAN_CONTEXT pcxScan,
  [in]                CLFS_SCAN_MODE     eScanMode,
  [in, out, optional] LPVOID             pReserved
);

Parametri

[in, out] pcxScan

Puntatore a una struttura CLFS_SCAN_CONTEXT allocata dal client che la funzione CreateLogContainerScanContext inizializza.

[in] eScanMode

Modalità di analisi dei contenitori.

I contenitori possono essere analizzati in una delle modalità di CLFS_SCAN_MODE seguenti.

Valore	Significato
CLFS_SCAN_INIT	Reinizializzare 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 .

[in, out, optional] pReserved

Riservato. Impostare pReserved su NULL.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

L'elenco seguente identifica i possibili codici di errore:

Commenti

L'ID di un contenitore di log viene restituito in: pcxScan-pinfoContainer-LogicalContainerId>>.

Nota I contesti di analisi CLFS (Common Log File System) non sono thread-safe. Non devono essere usati da più thread alla volta o passati a più di un'analisi asincrona alla volta.

Esempio

Per un esempio che usa questa funzione, vedere Enumerazione dei contenitori di log.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	clfsw32.h
Libreria	Clfsw32.lib
DLL	Clfsw32.dll