Fonction IoCheckFunctionAccess (ntifs.h)

Article
02/07/2025

La routine IoCheckFunctionAccess vérifie les paramètres et l’accès à une fonction par rapport à l’accès actuel accordé au fichier.

Syntaxe

NTSTATUS IoCheckFunctionAccess(
  ACCESS_MASK GrantedAccess,
  UCHAR       MajorFunction,
  UCHAR       MinorFunction,
  ULONG       IoControlCode,
  PVOID       Arg1,
  PVOID       Arg2
);

Paramètres

GrantedAccess

Valeur de masque qui spécifie l’accès actuellement accordé au fichier pour l’appelant.

MajorFunction

Code de fonction principal pour l’opération en cours d’exécution.

MinorFunction

Code de fonction secondaire pour l’opération en cours d’exécution.

IoControlCode

Code de contrôle de fonction d’E/S pour un code d’E/S de système de fichiers ou d’appareil.

Arg1

Argument facultatif qui dépend de la fonction principale. Ce paramètre pointe vers l’une des valeurs d’énumération FILE_INFORMATION_CLASS si MajorFunction indique qu’une fonction d’informations de fichier ou de requête est en cours d’exécution.

Arg2

Deuxième argument facultatif qui dépend de la fonction principale. Ce paramètre pointe vers l’une des valeurs d’énumération FS_INFORMATION_CLASS. Ce paramètre doit être fourni si MajorFunction indique qu’une fonction d’informations de fichier ou de requête est en cours d’exécution.

Valeur de retour

IoCheckFunctionAccess retourne STATUS_SUCCESS si l’appelant a accès au fichier ; sinon, elle retourne STATUS_ACCESS_DENIED.

Remarques

Le masque GrantedAccess ne peut pas contenir de mappages génériques. Autrement dit, IoCheckDesiredAccess doivent avoir été appelées pour retourner un masque complet.