Fonction FltQueryInformationByName (fltkernel.h)

Article
08/07/2023

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 la instance vers laquelle la création est ciblée.

Important

L’instance n’est pas nécessairement la instance de lancement. Il doit correspondre à la instance vers laquelle la création est ciblée, si ce paramètre n’a pas la valeur NULL. Si Instance n’a pas la valeur NULL, le rappel de précréation du filtre actuel n’est pas appelé. Les pré-rappels commencent par le filtre sous le filtre actuel.

[in] ObjectAttributes

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

[out] IoStatusBlock

Pointeur vers une structure de IO_STATUS_BLOCK contenant le bloc de status 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. Peut avoir l’une des valeurs suivantes :

Valeur	Type de structure vers laquelle FileInformation pointe
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 qui est 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 uniquement reconnue par le gestionnaire d’E/S et un système de fichiers ne doit jamais la recevoir. Cette valeur est disponible à partir de Windows 10, version 1803.

[in, optional] DriverContext

Pointeur vers l’espace de contexte du pilote.

Valeur retournée

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

Remarques

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

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1706
En-tête	fltkernel.h
Bibliothèque	FltMgr.lib
DLL	Fltmgr.sys

Voir aussi

FILE_INFORMATION_CLASS

Partager via