Fonction IoCheckQuerySetFileInformation (ntifs.h)

Article
02/26/2024

La routine IoCheckQuerySetFileInformation vérifie la validité des paramètres pour une opération de requête ou de définition d’informations de fichier.

Syntaxe

NTSTATUS IoCheckQuerySetFileInformation(
  FILE_INFORMATION_CLASS FileInformationClass,
  ULONG                  Length,
  BOOLEAN                SetOperation
);

Paramètres

FileInformationClass

Valeur d’énumération FILE_INFORMATION_CLASS qui spécifie la classe d’informations de fichier à vérifier.

Length

Taille, en octets, de la mémoire tampon requise pour l’opération d’informations de fichier spécifiée.

SetOperation

Valeur booléenne qui spécifie le type d’opération. Si SetOperation a la valeur TRUE, l’opération est une opération de fichier défini ; si la valeur est FALSE, il s’agit d’une opération de fichier de requête.

Valeur retournée

IoCheckQuerySetFileInformation retourne STATUS_SUCCESS si les paramètres sont valides ; sinon, elle retourne l’un des codes d’erreur suivants.

Code de retour	Description
STATUS_INVALID_INFO_CLASS	La valeur spécifiée dans FileInformationClass n’est pas une classe d’informations valide.
STATUS_INFO_LENGTH_MISMATCH	La taille de la mémoire tampon spécifiée dans Longueur est inférieure à la taille de mémoire tampon requise pour l’opération de fichier spécifiée.

Remarques

IoCheckQuerySetFileInformation est principalement utilisé par les serveurs réseau s’exécutant en mode noyau, car aucune vérification de la validité des paramètres n’est effectuée dans le chemin normal.