通过

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)

另请参阅

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile