Fonction FltSupportsFileContexts (fltkernel.h)

Article
02/29/2024

La routine FltSupportsFileContexts détermine si le système de fichiers prend en charge les contextes de fichiers pour un fichier donné. (Voir aussi FltSupportsFileContextsEx.)

Syntaxe

BOOLEAN FLTAPI FltSupportsFileContexts(
  [in] PFILE_OBJECT FileObject
);

Paramètres

[in] FileObject

Pointeur vers l’objet de fichier qui représente le fichier dont la prise en charge du contexte de fichier est interrogée. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.

Valeur retournée

FltSupportsFileContexts retourne TRUE si le système de fichiers prend en charge les contextes de fichiers pour l’objet de fichier ; FALSE dans le cas contraire.

Remarques

Les pilotes de minifiltre appellent FltSupportsFileContexts pour déterminer si le système de fichiers sous-jacent prend en charge intrinsèquement les contextes de fichiers pour le fichier représenté par le FileObject spécifié sans avoir à allouer un contexte et à tenter de le définir. Si un type de contexte n’est pas pris en charge sur un fichier, le minifiltre ne peut pas attacher de contexte à ce fichier.

Notez qu’un système de fichiers peut prendre en charge les contextes de fichiers pour certains types de fichiers, mais pas pour d’autres. Par exemple, NTFS et FAT ne prennent pas en charge les contextes de fichiers pour la pagination des fichiers.

Pour plus d’informations sur les contextes, consultez À propos des contextes de minifiltre.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Cette routine est disponible sur Windows Vista et versions ultérieures.
Plateforme cible	Universal
En-tête	fltkernel.h (inclure Fltkernel.h)
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL