Fonction IoCheckFunctionAccess (ntifs.h)

Article
02/26/2024

La routine IoCheckFunctionAccess vérifie les paramètres et l’accès d’une fonction par rapport à l’accès actuellement 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 E/S pour un appareil ou un code d’E/S de système de fichiers.

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 de requête ou de jeu 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 de requête ou de jeu est en cours d’exécution.

Valeur retournée

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

Remarques

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