IoCheckFunctionAccess 函数 (ntifs.h)

IoCheckFunctionAccess 例程根据当前授予对文件的访问权限检查函数的参数和访问权限。

语法

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

参数

GrantedAccess

掩码值,该值指定当前授予对调用方文件的访问权限。

MajorFunction

正在执行的操作的主要函数代码。

MinorFunction

所执行操作的次要函数代码。

IoControlCode

设备或文件系统 I/O 代码的 I/O 函数控制代码。

Arg1

依赖于主函数的可选参数。 如果 MajorFunction 指示正在执行查询或设置文件信息函数,则此参数指向FILE_INFORMATION_CLASS枚举值之一。

Arg2

依赖于主函数的可选第二个参数。 此参数指向 FS_INFORMATION_CLASS 枚举值之一。 如果 MajorFunction 指示正在执行查询或 set 文件信息函数,则必须提供此参数。

返回值

如果调用方有权访问该文件,IoCheckFunctionAccess 将返回STATUS_SUCCESS;否则,它将返回STATUS_ACCESS_DENIED。

注解

GrantedAccess 掩码不能包含任何泛型映射。 也就是说,以前必须调用 IoCheckDesiredAccess 才能返回完整掩码。

要求

要求
目标平台 Windows
标头 ntifs.h (包括 Ntifs.h)

另请参阅

FILE_INFORMATION_CLASS

FS_INFORMATION_CLASS

IoCheckDesiredAccess

SeAccessCheck