Функция IoCheckQuerySetFileInformation (ntifs.h)

  • Статья

Подпрограмма IoCheckQuerySetFileInformation проверяет допустимость параметров для операции запроса или задания сведений о файле.

Синтаксис

NTSTATUS IoCheckQuerySetFileInformation(
  FILE_INFORMATION_CLASS FileInformationClass,
  ULONG                  Length,
  BOOLEAN                SetOperation
);

Параметры

FileInformationClass

Значение перечисления FILE_INFORMATION_CLASS , указывающее класс сведений о файле для проверки.

Length

Размер (в байтах) буфера, необходимого для указанной операции со сведениями о файле.

SetOperation

Логическое значение, указывающее тип операции. Если setOperation имеет значение TRUE, операция является операцией установки файла; Значение false, это операция с файлом запроса.

Возвращаемое значение

IoCheckQuerySetFileInformation возвращает STATUS_SUCCESS, если параметры являются допустимыми; В противном случае возвращается один из следующих кодов ошибок.

Код возврата Описание
STATUS_INVALID_INFO_CLASS Значение, указанное в FileInformationClass , не является допустимым информационным классом.
STATUS_INFO_LENGTH_MISMATCH Размер буфера, указанный в поле Длина , меньше размера буфера, необходимого для указанной операции с файлом.

Комментарии

IoCheckQuerySetFileInformation используется главным образом сетевыми серверами, работающими в режиме ядра, так как проверка допустимости параметров не выполняется в обычном пути.

Требования

Требование Значение
Целевая платформа Windows
Header ntifs.h (включая Ntifs.h)

См. также раздел

FILE_INFORMATION_CLASS

ZwQueryInformationFile

ZwSetInformationFile