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

Подпрограмма NtQueryInformationFile возвращает различные типы сведений об объекте файла. См. также статью NtQueryInformationByName, которая может быть более эффективно использована для нескольких классов сведений о файлах.

Синтаксис

__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationFile(
  [in]  HANDLE                 FileHandle,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Параметры

[in] FileHandle

Дескриптор объекта файла. Дескриптор создается путем успешного вызова NtCreateFile или NtOpenFile либо эквивалентной процедуры создания или открытия файла.

[out] IoStatusBlock

Указатель на структуру IO_STATUS_BLOCK , которая получает окончательное состояние завершения и сведения об операции. Элемент Information получает количество байтов, которое эта подпрограмма фактически записывает в буфер FileInformation .

[out] FileInformation

Указатель на буфер, выделенный вызывающим объектом, в который подпрограмма записывает запрошенные сведения об объекте файла. Параметр FileInformationClass указывает тип сведений, которые запрашивает вызывающий объект.

[in] Length

Размер (в байтах) буфера, на который указывает FileInformation.

[in] FileInformationClass

Указывает тип возвращаемых сведений о файле в буфере, на который указывает FileInformation . Драйверы устройства и промежуточные драйверы могут указывать любое из следующих FILE_INFORMATION_CLASS значений (от наименьшего до самого высокого значения перечисления):

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

NtQueryInformationFile возвращает STATUS_SUCCESS или соответствующий код ошибки NTSTATUS.

Комментарии

NtQueryInformationFile возвращает сведения об указанном объекте файла. Обратите внимание, что он возвращает ноль в любом элементе структуры FILE_XXX_INFORMATION , которая не поддерживается определенным устройством или файловой системой.

При fileInformationClass = FileNameInformation имя файла возвращается в структуре FILE_NAME_INFORMATION . Точный синтаксис имени файла зависит от ряда факторов:

• Если вы открыли файл, отправив полный путь к NtCreateFile, ntQueryInformationFile возвращает этот полный путь.

• Если дескриптор ObjectAttributes-RootDirectory> был открыт по имени в вызове NtCreateFile, а затем файл был открыт ntCreateFile относительно этого дескриптора корневого каталога, ntQueryInformationFile возвращает полный путь.

• Если дескриптор ObjectAttributes-RootDirectory> был открыт идентификатором файла (с помощью флага FILE_OPEN_BY_FILE_ID) в вызове NtCreateFile, а затем файл был открыт ntCreateFile относительно этого дескриптора корневого каталога, ntQueryInformationFile возвращает относительный путь.

• Однако если у пользователя есть SeChangeNotifyPrivilege (описано в документации по Microsoft Windows SDK), ntQueryInformationFile во всех случаях возвращает полный путь.

• Если возвращается только относительный путь, строка имени файла не будет начинаться с обратной косой черты.

• Если возвращаются полный путь и имя файла, строка будет начинаться с одной обратной косой черты, независимо от ее расположения. Таким образом, файл C:\dir1\dir2\filename.ext будет отображаться как \dir1\dir2\filename.ext, а файл \server\share\dir1\dir2\filename.ext будет отображаться как \server\share\dir1\dir2\filename.ext.

Если NtQueryInformationFile завершается сбоем из-за переполнения буфера, драйверы, реализующие FileNameInformation , должны вернуть столько символов WCHAR имени файла, сколько поместится в буфере, и указать полную длину, необходимую в параметре FileNameLengthструктуры FILE_NAME_INFORMATION . Вы должны повторно выполнить запрос, используя длину имени файла, чтобы можно было получить полное имя файла. Драйверы, которые не следуют этому шаблону, могут требовать постепенного увеличения длины до тех пор, пока они не получите полное имя файла. Дополнительные сведения о работе с файлами см. в разделе Использование файлов в драйвере.

Вызывающие объект NtQueryInformationFile должны выполняться по адресу IRQL = PASSIVE_LEVEL и с включенными специальными APC ядра.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

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

FILE_ACCESS_INFORMATION

FILE_ALIGNMENT_INFORMATION

FILE_ALL_INFORMATION

FILE_ATTRIBUTE_TAG_INFORMATION

FILE_BASIC_INFORMATION

FILE_EA_INFORMATION

FILE_INTERNAL_INFORMATION

FILE_IO_PRIORITY_HINT_INFORMATION

FILE_IS_REMOTE_DEVICE_INFORMATION

FILE_MODE_INFORMATION

FILE_NAME_INFORMATION

FILE_NETWORK_OPEN_INFORMATION

FILE_POSITION_INFORMATION

FILE_STANDARD_INFORMATION

Использование версий Nt и Zw собственных процедур системных служб

NtCreateFile

NtQueryInformationByName

NtSetInformationFile