ClfsCreateScanContext-Funktion (wdm.h)

  • Artikel

Die ClfsCreateScanContext-Routine erstellt einen Scankontext, der zum Durchlaufen der Container eines angegebenen CLFS-Protokolls verwendet werden kann.

Syntax

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

Parameter

[in] plfoLog

Ein Zeiger auf eine LOG_FILE_OBJECT-Struktur , die einen CLFS-Stream darstellt. Der Überprüfungskontext wird für das Protokoll erstellt, das den zugrunde liegenden Speicher für diesen Stream bereitstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen von ClfsCreateLogFile abgerufen.

[in] cFromContainer

Der Index des ersten zu scannenden Containers. Container werden ab 0 (null) indiziert.

[in] cContainers

Die Anzahl der Container, die bei jedem Aufruf von ClfsScanLogContainers überprüft werden sollen.

[in] eScanMode

Ein Satz von Flags, die angeben, ob der Scankontext für das Vorwärts- oder Rückwärtsscannen eingerichtet ist und ob der Scankontext neu initialisiert werden soll. Die folgenden drei Flags sind für Aufrufer dieser Routine verfügbar.

Wert Bedeutung
CLFS_SCAN_FORWARD Richten Sie den Scankontext für das Scannen in Vorwärtsrichtung ein. Wenn beispielsweise Container 5 der zuletzt gescannte Container und cContainers den Wert 2 aufweist, würde eine Vorwärtsüberprüfung Deskriptoren für die Container 6 und 7 zurückgeben.
CLFS_SCAN_BACKWARD Richten Sie den Scankontext für die Überprüfung in rückwärts gerichteter Richtung ein. Wenn beispielsweise Container 5 der zuletzt gescannte Container und cContainers den Wert 2 aufweist, würde eine Rückwärtsüberprüfung Deskriptoren für die Container 4 und 3 zurückgeben.
CLFS_SCAN_INIT Initialisieren Sie den Scankontext erneut. Wenn ClfsScanLogContainers das nächste Mal aufgerufen wird, verhält es sich so, als würde es zum ersten Mal nach der Erstellung des Scankontexts aufgerufen.
 

Wenn pcxScan auf eine CLFS_SCAN_CONTEXT-Struktur zeigt, die zum ersten Mal an diese Routine übergeben wird, muss eines der Richtungsflags (CLFS_SCAN_FORWARD oder CLFS_SCAN_BACKWARD) festgelegt werden. Das flag CLFS_SCAN_INIT darf nicht festgelegt werden.

Wenn pcxScan auf eine CLFS_SCAN_CONTEXT-Struktur zeigt, die zuvor an diese Routine übergeben wurde, muss das flag CLFS_SCAN_INIT festgelegt werden. Außerdem muss nur eines der Richtungsflags (CLFS_SCAN_FORWARD oder CLFS_SCAN_BACKWARD) festgelegt werden.

[in, out] pcxScan

Ein Zeiger auf eine vom Aufrufer zugeordnete CLFS_SCAN_CONTEXT-Struktur , deren Member von dieser Routine initialisiert werden. Diese Struktur wird später an ClfsScanLogContainers übergeben.

Rückgabewert

ClfsCreateScanContext gibt bei Erfolg STATUS_SUCCESS zurück. Andernfalls wird einer der Fehlercodes in "Ntstatus.h" zurückgegeben.

Hinweise

Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System( Common Log File System).

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows.
Zielplattform Desktop
Kopfzeile wdm.h (wdm.h einschließen)
Bibliothek Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Weitere Informationen

ClfsScanLogContainers