Funzione IoCheckFunctionAccess (ntifs.h)

Articolo
02/29/2024

La routine IoCheckFunctionAccess controlla i parametri e l'accesso per una funzione rispetto all'accesso concesso corrente al file.

Sintassi

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

Parametri

GrantedAccess

Valore mask che specifica l'accesso attualmente concesso al file per il chiamante.

MajorFunction

Codice della funzione principale per l'operazione eseguita.

MinorFunction

Codice di funzione secondario per l'operazione eseguita.

IoControlCode

Codice di controllo della funzione di I/O per un dispositivo o un codice di I/O del file system.

Arg1

Argomento facoltativo che dipende dalla funzione principale. Questo parametro punta a uno dei valori di enumerazione FILE_INFORMATION_CLASS se MajorFunction indica che viene eseguita una query o una funzione di informazioni sui file impostata.

Arg2

Secondo argomento facoltativo che dipende dalla funzione principale. Questo parametro punta a uno dei valori di enumerazione FS_INFORMATION_CLASS. Questo parametro deve essere specificato se MajorFunction indica che viene eseguita una query o una funzione di informazioni sui file impostata.

Valore restituito

IoCheckFunctionAccess restituisce STATUS_SUCCESS se il chiamante ha accesso al file; in caso contrario, restituisce STATUS_ACCESS_DENIED.

Commenti

La maschera GrantedAccess non può contenere mapping generici. Ovvero , IoCheckDesiredAccess deve essere stato richiamato in precedenza per restituire una maschera completa.