Partager via


ClfsCreateScanContext, fonction (wdm.h)

La routine ClfsCreateScanContext crée un contexte d’analyse qui peut être utilisé pour itérer sur les conteneurs d’un journal CLFS spécifié.

Syntaxe

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
);

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT qui représente un flux CLFS. Le contexte d’analyse est créé pour le journal qui fournit le stockage sous-jacent pour ce flux. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateLogFile.

[in] cFromContainer

Index du premier conteneur à analyser. Les conteneurs sont indexés à partir de zéro.

[in] cContainers

Nombre de conteneurs à analyser avec chaque appel à ClfsScanLogContainers.

[in] eScanMode

Ensemble d’indicateurs qui spécifient si le contexte d’analyse est configuré pour l’analyse vers l’avant ou vers l’arrière et si le contexte d’analyse doit être réinitialisé. Les trois indicateurs suivants sont disponibles pour les appelants de cette routine.

Valeur Signification
CLFS_SCAN_FORWARD Configurez le contexte d’analyse pour l’analyse dans la direction vers l’avant. Par exemple, si le conteneur 5 est le conteneur le plus récemment analysé et cContainers est 2, une analyse vers l’avant retourne des descripteurs pour les conteneurs 6 et 7.
CLFS_SCAN_BACKWARD Configurez le contexte d’analyse pour l’analyse dans la direction descendante. Par exemple, si le conteneur 5 est le conteneur le plus récemment analysé et cContainers est 2, une analyse descendante retourne des descripteurs pour les conteneurs 4 et 3.
CLFS_SCAN_INIT Réinitialisez le contexte d’analyse. La prochaine fois ClfsScanLogContainers est appelée, elle se comporte comme si elle était appelée pour la première fois après la création du contexte d’analyse.
 

Si pcxScan pointe vers une structure CLFS_SCAN_CONTEXT qui est passée à cette routine pour la première fois, l’un des indicateurs de direction (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) doit être défini. L’indicateur CLFS_SCAN_INIT ne doit pas être défini.

Si pcxScan pointe vers une structure CLFS_SCAN_CONTEXT qui a été passée à cette routine précédemment, l’indicateur CLFS_SCAN_INIT doit être défini. En outre, un seul des indicateurs de direction (CLFS_SCAN_FORWARD ou CLFS_SCAN_BACKWARD) doit être défini.

[in, out] pcxScan

Pointeur vers une structure CLFS_SCAN_CONTEXT allouée par l’appelant dont les membres sont initialisés par cette routine. Cette structure est passée ultérieurement à ClfsScanLogContainers.

Valeur de retour

ClfsCreateScanContext retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur dans Ntstatus.h.

Remarques

Pour obtenir une explication des concepts et de la terminologie CLFS, consultez Common Log File System.

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
plateforme cible Bureau
d’en-tête wdm.h (include Wdm.h)
bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

ClfsScanLogContainers