IoCheckFunctionAccess function (ntifs.h)

Article
02/22/2024

The IoCheckFunctionAccess routine checks the parameters and access for a function against the current granted access to the file.

Syntax

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

Parameters

GrantedAccess

Mask value that specifies the access currently granted to the file for the caller.

MajorFunction

Major function code for the operation being performed.

MinorFunction

Minor function code for the operation being performed.

IoControlCode

I/O function control code for a device or file system I/O code.

Arg1

Optional argument that depends on the major function. This parameter points to one of the FILE_INFORMATION_CLASS enum values if MajorFunction indicates a query or set file information function is being performed.

Arg2

Optional second argument that depends on the major function. This parameter points to one of the FS_INFORMATION_CLASS enum values. This parameter must be supplied if MajorFunction indicates a query or set file information function is being performed.

Return value

IoCheckFunctionAccess returns STATUS_SUCCESS if the caller has access to the file; otherwise, it returns STATUS_ACCESS_DENIED.

Remarks

The GrantedAccess mask cannot contain any generic mappings. That is, IoCheckDesiredAccess must have been previously invoked to return a full mask.

Requirements

Requirement	Value
Target Platform	Windows
Header	ntifs.h (include Ntifs.h)