Funzione ClfsCreateScanContext (wdm.h)

Articolo
08/08/2023

La routine ClfsCreateScanContext crea un contesto di analisi che può essere usato per eseguire l'iterazione dei contenitori di un log CLFS specificato.

Sintassi

CLFSUSER_API NTSTATUS ClfsCreateScanContext(
  [in]      PLOG_FILE_OBJECT   plfoLog,
  [in]      ULONG              cFromContainer,
  [in]      ULONG              cContainers,
  [in]      CLFS_SCAN_MODE     eScanMode,
  [in, out] PCLFS_SCAN_CONTEXT pcxScan
);

Parametri

[in] plfoLog

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta un flusso CLFS. Il contesto di analisi viene creato per il log che fornisce l'archiviazione sottostante per tale flusso. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.

[in] cFromContainer

Indice del primo contenitore da analizzare. I contenitori vengono indicizzati a partire da zero.

[in] cContainers

Numero di contenitori da analizzare con ogni chiamata a ClfsScanLogContainers.

[in] eScanMode

Set di flag che specificano se il contesto di analisi è configurato per l'analisi in avanti o indietro e se il contesto di analisi deve essere reinizializzato. I tre flag seguenti sono disponibili per i chiamanti di questa routine.

Valore	Significato
CLFS_SCAN_FORWARD	Configurare il contesto di analisi per l'analisi nella direzione in avanti. Ad esempio, se il contenitore 5 è il contenitore analizzato più di recente e cContainers è 2, un'analisi in avanti restituirà i descrittori per i contenitori 6 e 7.
CLFS_SCAN_BACKWARD	Configurare il contesto di analisi per l'analisi nella direzione indietro. Ad esempio, se il contenitore 5 è il contenitore analizzato più di recente e cContainers è 2, un'analisi indietro restituirà i descrittori per i contenitori 4 e 3.
CLFS_SCAN_INIT	Reinizializzare il contesto di analisi. La prossima volta che clfsScanLogContainers viene chiamato, si comporta come se fosse stato chiamato per la prima volta dopo la creazione del contesto di analisi.

Se pcxScan punta a una struttura di CLFS_SCAN_CONTEXT passata a questa routine per la prima volta, è necessario impostare uno dei flag di direzione (CLFS_SCAN_FORWARD o CLFS_SCAN_BACKWARD). Il flag CLFS_SCAN_INIT non deve essere impostato.

Se pcxScan punta a una struttura CLFS_SCAN_CONTEXT passata a questa routine in precedenza, è necessario impostare il flag di CLFS_SCAN_INIT. Inoltre, è necessario impostare uno e solo uno dei flag di direzione (CLFS_SCAN_FORWARD o CLFS_SCAN_BACKWARD).

[in, out] pcxScan

Puntatore a una struttura CLFS_SCAN_CONTEXT allocata dal chiamante i cui membri vengono inizializzati da questa routine. Questa struttura viene successivamente passata a ClfsScanLogContainers.

Valore restituito

ClfsCreateScanContext restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore in Ntstatus.h.

Commenti

Per una spiegazione dei concetti e della terminologia CLFS, vedere Common Log File System.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

ClfsScanLogContainers

Condividi tramite