Share via

структура FILE_NAMES_INFORMATION (ntifs.h)

  • Статья

Структура FILE_NAMES_INFORMATION , используемая для запроса подробных сведений об именах файлов в каталоге.

Синтаксис

typedef struct _FILE_NAMES_INFORMATION {
  ULONG NextEntryOffset;
  ULONG FileIndex;
  ULONG FileNameLength;
  WCHAR FileName[1];
} FILE_NAMES_INFORMATION, *PFILE_NAMES_INFORMATION;

Члены

NextEntryOffset

Смещение байтов для следующей записи FILE_NAMES_INFORMATION , если в буфере присутствует несколько записей. Этот элемент равен нулю, если другие записи не следуют за этим элементом.

FileIndex

Байтовая смещение файла в родительском каталоге. Этот элемент не определен для файловых систем, таких как NTFS, в которых положение файла в родительском каталоге не является фиксированным и может быть изменено в любое время для поддержания порядка сортировки.

FileNameLength

Длина строки имени файла.

FileName[1]

Первый символ строки имени файла. За этим в памяти следует остаток строки.

Комментарии

Эти сведения можно запросить с помощью любого из следующих способов:

  • Вызовите ZwQueryDirectoryFile, передав FileNamesInformation в качестве значения FileInformationClass и передавая выделенный вызывающим FILE_NAMES_INFORMATION структурированный буфер в качестве значения FileInformation.

  • Создайте IRP с основным кодом функции IRP_MJ_DIRECTORY_CONTROL и дополнительным кодом функции IRP_MN_QUERY_DIRECTORY.

Для запроса этих сведений не требуются определенные права доступа.

Эта структура должна быть выровнена по длинной (4-байтовой) границе. Если буфер содержит две или более из этих структур, значение NextEntryOffset в каждой записи, за исключением последней, попадает на 4-байтовую границу.

Требования

Требование Значение
Заголовок ntifs.h (включая Ntifs.h, Fltkernel.h)

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

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile