FsRtlQueryInformationFile, fonction (ntifs.h)

Article
12/21/2024

FsRtlQueryInformationFile génère un IRP de requête de fichier explicite (IRP_MJ_QUERY_INFORMATION), l’envoie à la pile, attend de façon synchrone qu’il se termine et retourne le résultat. Cette fonction permet à l’appelant d’effectuer cette action en FileObject au lieu de gérer.

Syntaxe

NTSTATUS FsRtlQueryInformationFile(
  [in]  PFILE_OBJECT           FileObject,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass,
  [out] PULONG                 RetFileInformationSize
);

Paramètres

[in] FileObject

Pointeur vers la FILE_OBJECT pour envoyer l’opération.

[out] FileInformation

Pointeur vers une mémoire tampon allouée par l’appelant pour recevoir les informations de fichier interrogées.

[in] Length

Taille en octets de la mémoire tampon vers laquelle FileInformation pointe.

[in] FileInformationClass

Valeur FILE_INFORMATION_CLASS qui spécifie le type d’informations de fichier interrogées.

[out] RetFileInformationSize

Reçoit le nombre d’octets écrits (retournés) dans la mémoire tampon vers laquelle FileInformation pointe.

Valeur de retour

FsRtlKernelFsControlFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple l’une des valeurs suivantes.

Valeur	Signification
STATUS_INSUFFICIENT_RESOURCES	Un échec d’allocation de pool s’est produit.
STATUS_INVALID_PARAMETER	Un paramètre non valide a été fourni (par exemple, un FileObjectnon valide).

Remarques

Cette routine suppose que toutes les mémoires tampons passées sont des mémoires tampons en mode noyau.

Exigences

Exigence	Valeur
d’en-tête	ntifs.h

Voir aussi

ZwQueryInformationFile

Partager via