Funzione ClfsScanLogContainers (wdm.h)
La routine ClfsScanLogContainers recupera informazioni descrittive per una sequenza di contenitori che appartengono a un log CLFS specifico.
Sintassi
CLFSUSER_API NTSTATUS ClfsScanLogContainers(
[in, out] PCLFS_SCAN_CONTEXT pcxScan,
[in] CLFS_SCAN_MODE eScanMode
);
Parametri
[in, out] pcxScan
Puntatore a una struttura CLFS_SCAN_CONTEXT . Il chiamante ha allocato in precedenza la struttura e l'ha inizializzata chiamando ClfsCreateScanContext. In particolare, il membro pInfoContainer è stato inizializzato per puntare a una matrice di strutture CLFS_CONTAINER_INFORMATION e il membro cContainers è stato inizializzato sul numero di elementi nella matrice. In caso di restituzione, le strutture nella matrice ricevono informazioni descrittive per i contenitori nella sequenza.
[in] eScanMode
Set di flag che specificano la direzione dell'analisi e se il contesto di analisi deve essere chiuso. I flag seguenti sono disponibili per i chiamanti di questa routine.
| Valore | Significato |
|---|---|
| CLFS_SCAN_FORWARD | Analizza nella direzione in avanti. Ad esempio, se il contenitore 5 è il contenitore analizzato più di recente e pxcScan->cContainers è uguale a due, questa routine restituirà i descrittori per i contenitori 6 e 7. |
| CLFS_SCAN_BACKWARD | Analizza nella direzione indietro. Ad esempio, se il contenitore 5 è il contenitore analizzato più di recente e pxcScan->cContainers è uguale a due, questa routine restituirà i descrittori per i contenitori 4 e 3. |
| CLFS_SCAN_CLOSE | Liberare tutte le risorse associate al contesto di analisi a cui punta pcxScan. |
Se il flag CLFS_SCAN_CLOSE è impostato, i flag CLFS_SCAN_FORWARD e CLFS_SCAN_BACKWARD devono essere chiari.
Se il flag di CLFS_SCAN_CLOSE è deselezionato, è necessario impostare solo uno dei flag di direzione (CLFS_SCAN_FORWARD o CLFS_SCAN_BACKWARD).
Valore restituito
ClfsScanLogContainers restituisce STATUS_SUCCESS se ha esito positivo; in caso contrario, restituisce uno dei codici di errore definiti in Ntstatus.h.
Commenti
CLFS usa la struttura CLFS_SCAN_CONTEXT per tenere traccia dell'avvio di un'analisi del contenitore (membro cIndex ) e del numero di contenitori analizzati in ogni chiamata a ClfsScanLogContainers. Il valore N del membro cContainers specifica che ogni volta che viene chiamato ClfsScanLogContainers , vengono analizzati i contenitori N successivi.
Il membro cContainersReturned della struttura CLFS_SCAN_CONTEXT riceve il numero di contenitori effettivamente analizzati in una singola chiamata a ClfsScanLogContainers.
Quando ClfsScanLogContainers restituisce STATUS_NO_MORE_ENTRIES, non è necessario analizzare altri contenitori.
Al termine dell'uso del contesto di analisi a cui punta pcxScan, è necessario chiamare ClfsScanLogContainers, con eScanMode uguale a CLFS_SCAN_CLOSE, per liberare tutte le risorse associate al contesto di analisi.
Per una spiegazione dei concetti e della terminologia di 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, Ntddk.h, Ntifs.h) |
| Libreria | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | <= APC_LEVEL |