struktur FILE_NAMES_INFORMATION (ntifs.h)

  • Artikel

Struktur FILE_NAMES_INFORMATION digunakan untuk mengkueri informasi terperinci tentang nama file dalam direktori.

Sintaks

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

Anggota

NextEntryOffset

Offset byte untuk entri FILE_NAMES_INFORMATION berikutnya, jika beberapa entri ada dalam buffer. Anggota ini nol jika tidak ada entri lain yang mengikuti yang satu ini.

FileIndex

Offset byte file dalam direktori induk. Anggota ini tidak terdefinisi untuk sistem file, seperti NTFS, di mana posisi file dalam direktori induk tidak diperbaiki dan dapat diubah kapan saja untuk mempertahankan urutan sortir.

FileNameLength

Panjang string nama file.

FileName[1]

Karakter pertama dari string nama file. Ini diikuti dalam memori oleh sisa string.

Keterangan

Informasi ini dapat dikueri dengan salah satu cara berikut:

  • Panggil ZwQueryDirectoryFile, meneruskan FileNamesInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_NAMES_INFORMATION terstruktur sebagai nilai FileInformation.

  • Buat IRP dengan kode fungsi utama IRP_MJ_DIRECTORY_CONTROL dan kode fungsi minor IRP_MN_QUERY_DIRECTORY.

Tidak diperlukan hak akses khusus untuk mengkueri informasi ini.

Struktur ini harus diselaraskan pada batas LONG (4-byte). Jika buffer berisi dua atau beberapa struktur ini, nilai NextEntryOffset di setiap entri, kecuali yang terakhir, berada di batas 4-byte.

Persyaratan

Persyaratan Nilai
Header ntifs.h (termasuk Ntifs.h, Fltkernel.h)

Lihat juga

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile