FltSupportsFileContextsEx-Funktion (fltkernel.h)

Die FltSupportsFileContextsEx-Routine bestimmt, ob das Dateisystem oder der Filter-Manager Dateikontexte für eine bestimmte Datei unterstützt.

Syntax

BOOLEAN FLTAPI FltSupportsFileContextsEx(
  [in]           PFILE_OBJECT  FileObject,
  [in, optional] PFLT_INSTANCE Instance
);

Parameter

[in] FileObject

Zeiger auf das Dateiobjekt, das die Datei darstellt, deren Dateikontextunterstützung abgefragt wird. Dieser Parameter ist erforderlich und darf nicht NULL sein.

[in, optional] Instance

Undurchsichtiger instance Zeiger für den Aufrufer. Dieser Parameter ist optional und kann NULL sein. Weitere Informationen zu diesem Parameter finden Sie im Abschnitt Hinweise auf dieser Seite.

Rückgabewert

FltSupportsFileContextsEx gibt TRUE zurück, wenn das Dateisystem oder der Filter-Manager Dateikontexte für die Datei unterstützt. False andernfalls.

Hinweise

Minifiltertreiber können die FltSupportsFileContextsEx-Routine aufrufen, um zu bestimmen, ob das zugrunde liegende Dateisystem oder der Filter-Manager Dateikontexte für die von FileObject dargestellte Datei unterstützt, ohne einen Kontext zuordnen und festlegen zu müssen. Wenn ein Kontexttyp für eine Datei nicht unterstützt wird, kann der Minifilter dieser Datei keinen Kontext anfügen.

Bei Dateisystemen (z. B. FAT), die nur einen einzelnen Datenstrom pro Datei unterstützen, entsprechen Dateikontexte Streamkontexten. Solche Dateisysteme unterstützen normalerweise Streamkontexte, aber keine Dateikontexte. Stattdessen bietet der Filter-Manager Unterstützung für Dateikontexte, wobei die vorhandene Unterstützung für Streamkontexte des Dateisystems verwendet wird. Für Minifilterinstanzen, die an diese Dateisysteme angefügt sind, gibt FltSupportsFileContextsFALSE zurück, während FltSupportsFileContextsExTRUE zurückgibt (wenn ein gültiger Wert ohne NULL für den Instanzparameter übergeben wird).

Wenn ein Wert ohne NULL für den Instance-Parameter angegeben wird, gibt FltSupportsFileContextsExTRUE zurück, wenn das Dateisystem oder der Filter-Manager Dateikontexte für die Datei unterstützt. False andernfalls.

Wenn der Instance-ParameterNULL ist, gibt FltSupportsFileContextsEx nur TRUE zurück, wenn das Dateisystem Dateikontexte für die Datei unterstützt. Andernfalls wird FALSE zurückgegeben, auch wenn der Filter-Manager Dateikontexte für die Datei unterstützt.

Beachten Sie, dass ein Dateisystem möglicherweise Dateikontexte für einige Dateitypen unterstützt, aber nicht für andere. NTFS und FAT unterstützen beispielsweise keine Dateikontexte für Auslagerungsdateien.

Weitere Informationen zu Kontexten finden Sie unter Informationen zu Minifilterkontexten.

Anforderungen

Weitere Informationen

FltAllocateContext

FltDeleteContext

FltDeleteFileContext

FltGetFileContext

FltReleaseContext

FltSetFileContext

FltSupportsFileContexts