Freigeben über


FltCloseSectionForDataScan-Funktion (fltkernel.h)

Die FltCloseSectionForDataScan-Routine schließt ein Abschnittsobjekt, das einem Dateistream zugeordnet ist.

Syntax

NTSTATUS FLTAPI FltCloseSectionForDataScan(
  [in] PFLT_CONTEXT SectionContext
);

Parameter

[in] SectionContext

Ein Zeiger auf den zu schließenden Abschnittskontext.

Rückgabewert

FltCloseSectionForDataScan gibt STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden Werte.

Rückgabecode Beschreibung
STATUS_INVALID_PARAMETER
Der Abschnittskontext wurde nicht ordnungsgemäß erstellt. Ein zugeordneter Abschnittskontext muss zuerst an FltCreateSectionForDataScan übergeben werden. Dies ist ein Fehlercode.
STATUS_NOT_FOUND
Der Abschnittskontext ist bereits geschlossen.

Hinweise

Minifilter verwenden die FltCloseSectionForDataScan-Routine , um die Zuordnung und das Entfernen eines Abschnittskontexts aus einem Dateiobjekt zu beheben. Alle zuvor an FltCreateSectionForDataScan übergebenen Abschnittskontexte müssen an FltCloseSectionForDataScan übergeben werden. Andernfalls können Minifilter FltReleaseContext aufrufen, wenn der Abschnittskontext FltAllocateContext zugeordnet wurde, aber kein Abschnitt mit FltCreateSectionForDataScan erstellt wurde.

Nachdem FltCloseSectionForDataScan zurückgegeben wurde, werden Vorgänge, die mit dem von SectionContext beschriebenen Abschnitt in Konflikt stehen, vom Filter-Manager nicht synchronisiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Die FltCloseSectionForDataScan-Routine ist ab Windows 8 verfügbar.
Zielplattform Universell
Header fltkernel.h (include Fltkernel.h)
Bibliothek FltMgr.lib
IRQL <= APC_LEVEL

Weitere Informationen

FltAllocateContext

FltCreateSectionForDataScan

FltDeleteContext