IoCheckQuerySetFileInformation 函数 (ntifs.h)
IoCheckQuerySetFileInformation 例程检查查询或设置文件信息操作的参数的有效性。
语法
NTSTATUS IoCheckQuerySetFileInformation(
FILE_INFORMATION_CLASS FileInformationClass,
ULONG Length,
BOOLEAN SetOperation
);
参数
FileInformationClass
一个FILE_INFORMATION_CLASS枚举值，该值指定要检查的文件信息类。
Length
指定文件信息操作所需的缓冲区的大小（以字节为单位）。
SetOperation
指定操作类型的布尔值。 如果 SetOperation 为 TRUE，则操作为 set 文件操作;如果 为 FALSE， 则为查询文件操作。
返回值
如果参数有效，IoCheckQuerySetFileInformation 将返回STATUS_SUCCESS;否则，它将返回以下错误代码之一。
| 返回代码 | 说明 |
|---|---|
| STATUS_INVALID_INFO_CLASS | FileInformationClass 中指定的值不是有效的信息类。 |
| STATUS_INFO_LENGTH_MISMATCH | Length 中指定的缓冲区大小小于指定文件操作所需的缓冲区大小。 |
注解
IoCheckQuerySetFileInformation 主要用于在内核模式下运行的网络服务器，因为常规路径中没有执行此类参数有效性检查。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | Windows |
| 标头 | ntifs.h (包括 Ntifs.h) |