Функция ZwQueryInformationFile (wdm.h)

Подпрограмма ZwQueryInformationFile возвращает различные виды сведений об объекте файла.

Синтаксис

NTSYSAPI NTSTATUS ZwQueryInformationFile(
  [in]  HANDLE                 FileHandle,
  [out] PIO_STATUS_BLOCK       IoStatusBlock,
  [out] PVOID                  FileInformation,
  [in]  ULONG                  Length,
  [in]  FILE_INFORMATION_CLASS FileInformationClass
);

Параметры

[in] FileHandle

Обработка объекта файла. Дескриптор создается с помощью успешного вызова ZwCreateFile или ZwOpenFile.

[out] IoStatusBlock

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

[out] FileInformation

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

[in] Length

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

[in] FileInformationClass

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

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

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

Замечания

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

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

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

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

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

• Однако если пользователь имеет SeChangeNotifyPrivilege, ZwQueryInformationFile возвращает полный путь во всех случаях.

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

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

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

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

Если вызов этой функции происходит в пользовательском режиме, следует использовать имя NtQueryInformationFile вместо ZwQueryInformationFile.

Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.

Требования

См. также

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

ZwCreateFile

ZwSetInformationFile