Функция IoCheckFunctionAccess (ntifs.h)
Подпрограмма 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.
Комментарии
Маска GrantedAccess не может содержать универсальные сопоставления. То есть ioCheckDesiredAccess должен быть ранее вызван для возврата полной маски.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | ntifs.h (включая Ntifs.h) |