FltQueryInformationByName, fonction (fltkernel.h)

Article
02/06/2025

La routine FltQueryInformationByName retourne les informations demandées sur un fichier nommé.

Syntaxe

NTSTATUS FLTAPI FltQueryInformationByName(
  [in]           PFLT_FILTER               Filter,
  [in, optional] PFLT_INSTANCE             Instance,
  [in]           POBJECT_ATTRIBUTES        ObjectAttributes,
  [out]          PIO_STATUS_BLOCK          IoStatusBlock,
  [out]          PVOID                     FileInformation,
  [in]           ULONG                     Length,
  [in]           FILE_INFORMATION_CLASS    FileInformationClass,
  [in, optional] PIO_DRIVER_CREATE_CONTEXT DriverContext
);

Paramètres

[in] Filter

Spécifie le filtre qui lance cette opération.

[in, optional] Instance

Spécifie l’instance vers laquelle la création est ciblée.

Important

instance n’est pas nécessairement l’instance de lancement. Elle doit correspondre à l’instance vers laquelle la création est ciblée, si ce paramètre n’est pasNULL. Si instance n’est pasNULL, le rappel de précréation du filtre actuel n’est pas appelé. Les rappels antérieurs commencent par le filtre sous le filtre actuel.

[in] ObjectAttributes

Pointeur vers une structure [OBJECT_ATTRIBUTES] avec les attributs à utiliser pour l’objet fichier (par exemple, son nom, son SECURITY_DESCRIPTOR, etc.).

[out] IoStatusBlock

Pointeur vers une structure IO_STATUS_BLOCK contenant le bloc d’état d’E/S de l’appelant.

[out] FileInformation

Pointeur vers une structure qui reçoit les informations demandées retournées sur le fichier. Le type de structure est déterminé par FileInformationClass.

[in] Length

Longueur, en octets, de la mémoire tampon FileInformation.

[in] FileInformationClass

Valeur d’énumération FILE_INFORMATION_CLASS qui spécifie le type d’informations à retourner sur le fichier. Il peut s’agir de l’une des valeurs suivantes :

Valeur	Type de structure qui FileInformation pointe vers
FileStatInformation	FILE_STAT_INFORMATION
FileStatLxInformation	**FILE_STAT_LX_INFORMATION
FileCaseSensitiveInformation	FILE_CASE_SENSITIVE_INFORMATION. L’appelant doit avoir ouvert le fichier avec l’indicateur FILE_READ_ATTRIBUTES spécifié dans le paramètre DesiredAccess. Cette valeur est disponible à partir de Windows 10 version 1803.
FileCaseSensitiveInformationForceAccessCheck	FILE_CASE_SENSITIVE_INFORMATION. Il s’agit d’une version spéciale de l’opération FileCaseSensitiveInformation utilisée pour forcer le Gestionnaire d’E/S à effectuer des vérifications d’accès pour le pilote en mode noyau, comme les vérifications qui s’appliquent à un appelant en mode utilisateur. Cette opération est reconnue uniquement par le Gestionnaire d’E/S et un système de fichiers ne doit jamais le recevoir. Cette valeur est disponible à partir de Windows 10 version 1803.

[in, optional] DriverContext

Pointeur vers l’espace de contexte du pilote.

Valeur de retour

Retourne STATUS_SUCCESS si l’opération réussit. Sinon, retourne un code d’erreur NTSTATUS approprié.

Remarques

Cette fonction retourne des informations demandées sur un fichier sans ouvrir le fichier réel. Les informations retournées sont déterminées par la FileInformationClass spécifiée, et elles sont placées dans la mémoire tampon FileInformation de l’appelant.

Si instance n’est pas NULL, la création sera ciblée sur l’instance spécifiée, en appelant tous les filtres sous le filtre actuel avant d’envoyer les E/S vers le bas. Si instance est NULL, les E/S sont toujours envoyées en haut de la pile de filtres.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1706
d’en-tête	fltkernel.h
bibliothèque	FltMgr.lib
DLL	Fltmgr.sys

Voir aussi

FILE_INFORMATION_CLASS

Partager via