Fonction FsRtlQueryInformationFile (ntifs.h)

Article
02/26/2024

FsRtlQueryInformationFile génère un IRP (IRP_MJ_QUERY_INFORMATION) de requête de fichier explicite, l’envoie dans 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 par FileObject au lieu de handle.

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 le FILE_OBJECT sur lequel envoyer l’opération.

[out] FileInformation

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

[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 retournée

FsRtlKernelFsControlFile retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, comme 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 Objet FileObject non valide).

Remarques

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

Configuration requise

Condition requise	Valeur
En-tête	ntifs.h

Voir aussi

ZwQueryInformationFile

Partager via