FltIsDirectory-Funktion (fltkernel.h)

Artikel
02/06/2025

Ein Minifiltertreiber ruft die FltIsDirectory Routine auf, um zu bestimmen, ob ein bestimmtes Dateiobjekt ein Verzeichnis darstellt.

Syntax

NTSTATUS FLTAPI FltIsDirectory(
  [in]  PFILE_OBJECT  FileObject,
  [in]  PFLT_INSTANCE Instance,
  [out] PBOOLEAN      IsDirectory
);

Parameter

[in] FileObject

Zeiger auf ein bereits geöffnetes Dateiobjekt.

[in] Instance

Undurchsichtiger Instanzzeiger für die Instanz, die diesem Dateiobjekt zugeordnet ist.

[out] IsDirectory

Zeiger auf eine vom Aufrufer bereitgestellte boolesche Variable. Bei Rückgabe empfängt diese Variable TRUE, wenn das Dateiobjekt ein Verzeichnis darstellt, FALSE andernfalls.

Rückgabewert

FltIsDirectory gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. folgendes:

Rückgabecode	Beschreibung
STATUS_NOT_SUPPORTED	Dieser Fehlercode wird zurückgegeben, wenn das Dateisystem Streamkontexte nicht unterstützt. Beachten Sie, dass FltIsDirectory- ab Windows Vista Verzeichnisinformationen auch für Dateisysteme zurückgibt, die Streamkontexte nicht unterstützen.

Bemerkungen

FltIsDirectory die gewünschten Informationen aus dem internen Streamkontext-Manager des Filter-Managers abrufen. Der Filter-Manager speichert diese Informationen für zukünftige Abfragen in diesem Datenstrom zwischen.

Hinweis Diese Routine kann nur für ein geöffnetes Dateiobjekt aufgerufen werden.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Routine ist unter Microsoft Windows 2000 Update Rollup 1 für SP4, Windows XP SP2, Microsoft Windows Server 2003 SP1 und höher verfügbar. Beachten Sie, dass diese Routine unter Windows 2000 SP4 oder früher nicht verfügbar ist.
Zielplattform-	Universal
Header-	fltkernel.h (include FltKernel.h)
Library	Fltmgr.lib
DLL-	Fltmgr.sys
IRQL-	<= APC_LEVEL

Siehe auch

FsRtlSupportsPerStreamContexts

Freigeben über