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) |