Funzione IoCheckFunctionAccess (ntifs.h)
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.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | ntifs.h (include Ntifs.h) |