Поделиться через


структура 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.

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

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

Требования

Требование Ценность
заголовка ntifs.h (include Ntifs.h, Fltkernel.h)

См. также

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile