Функция IoCheckFunctionAccess (ntifs.h)

Статья
02/26/2024

Подпрограмма IoCheckFunctionAccess проверяет параметры и доступ для функции с текущим предоставленным доступом к файлу.

Синтаксис

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

Параметры

GrantedAccess

Значение маски, указывающее доступ, предоставленный в данный момент файлу для вызывающего объекта.

MajorFunction

Код основной функции для выполняемой операции.

MinorFunction

Дополнительный код функции для выполняемой операции.

IoControlCode

Код управления функцией ввода-вывода для кода ввода-вывода устройства или файловой системы.

Arg1

Необязательный аргумент, зависящий от основной функции. Этот параметр указывает на одно из значений перечисления FILE_INFORMATION_CLASS , если MajorFunction указывает на выполнение функции сведений о запросе или наборе файлов.

Arg2

Необязательный второй аргумент, зависящий от основной функции. Этот параметр указывает на одно из FS_INFORMATION_CLASS значений перечисления. Этот параметр должен быть указан, если MajorFunction указывает, что выполняется функция сведений о файле запроса или набора.

Возвращаемое значение

IoCheckFunctionAccess возвращает STATUS_SUCCESS, если вызывающий объект имеет доступ к файлу; в противном случае возвращается STATUS_ACCESS_DENIED.