CLS_SCAN_CONTEXT-Struktur (clfs.h)

Artikel
08/22/2023

Enthält Informationen zu den Containern, die von ScanLogContainers gescannt werden, die Art der Überprüfung, die ausgeführt wird, und einen Cursor zum Nachverfolgen der gescannten Container.

Syntax

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;

Member

cidNode

Die ID des aktuellen Knotens. Weitere Informationen finden Sie unter CLFS_NODE_ID.

hLog

Ein Handle für das zu überprüfende Protokoll, das aus CreateLogFile mit Berechtigungen zum Überprüfen der Protokollcontainer abgerufen wird.

cIndex

Der Index des aktuellen Containers.

cContainers

Die Anzahl der systemseitig zugeordneten CLFS_CONTAINER_INFORMATION Strukturen in einem Array, auf das pinfoContainer verweist.

Das heißt, dieses Element ist die Anzahl der Container, die bei jedem Scanaufruf überprüft werden sollen. Der Aufrufer weiß, dass die Überprüfung abgeschlossen ist, wenn die Anzahl der zurückgegebenen Container kleiner als dieser Wert ist.

cContainersReturned

Die Anzahl der Container, die nach einem Aufruf von ScanLogContainers zurückgegeben werden.

eScanMode

Der Modus, in dem Container gescannt werden.

Container können in einem der folgenden Modi überprüft werden.

Wert	Bedeutung
CLFS_SCAN_INIT	Initialisiert den Scankontext, ordnet jedoch nicht den zugeordneten Speicher zu. Die Initialisierung ist destruktiv, da alle Daten, die im aktuellen Scankontext gespeichert sind, verloren gehen.
CLFS_SCAN_CLOSE	Hebt die Initialisierung des Scankontexts auf und hebt die Zuordnung des Systemspeichers auf, der einem Überprüfungskontext zugeordnet ist.
CLFS_SCAN_FORWARD	Bewirkt, dass der nächste Aufruf von ScanLogContainers vorwärts fortgesetzt wird. Kann nicht verwendet werden, wenn CLFS_SCAN_BACKWARD angegeben ist.
CLFS_SCAN_BACKWARD	Bewirkt, dass der nächste Aufruf von ScanLogContainers rückwärts verläuft. Kann nicht verwendet werden, wenn CLFS_SCAN_FORWARD angegeben ist.

pinfoContainer

Ein Zeiger auf ein vom Client zugewiesenes Array von CLFS_CONTAINER_INFORMATION Strukturen, die nach jedem erfolgreichen Aufruf von ScanLogContainers gefüllt werden sollen.