Функция 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) |