struktur FILE_ID_BOTH_DIR_INFORMATION (ntifs.h)

  • Artikel

Struktur FILE_ID_BOTH_DIR_INFORMATION digunakan untuk mengkueri informasi nomor referensi file untuk file dalam direktori.

Sintaks

typedef struct _FILE_ID_BOTH_DIR_INFORMATION {
  ULONG         NextEntryOffset;
  ULONG         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  ULONG         FileAttributes;
  ULONG         FileNameLength;
  ULONG         EaSize;
  CCHAR         ShortNameLength;
  WCHAR         ShortName[12];
  LARGE_INTEGER FileId;
  WCHAR         FileName[1];
} FILE_ID_BOTH_DIR_INFORMATION, *PFILE_ID_BOTH_DIR_INFORMATION;

Anggota

NextEntryOffset

Offset byte dari entri FILE_ID_BOTH_DIR_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.

CreationTime

Waktu ketika file dibuat.

LastAccessTime

Terakhir kali file diakses.

LastWriteTime

Terakhir kali informasi ditulis ke file.

ChangeTime

Terakhir kali file diubah.

EndOfFile

Posisi akhir file baru absolut sebagai offset byte dari awal file. EndOfFile menentukan offset byte ke akhir file. Karena nilai ini berbasis nol, nilai ini sebenarnya mengacu pada byte gratis pertama dalam file. Dengan kata lain, EndOfFile adalah offset ke byte segera setelah byte terakhir yang valid dalam file.

AllocationSize

Ukuran alokasi file, dalam byte. Biasanya, nilai ini adalah kelipatan sektor atau ukuran kluster dari perangkat fisik yang mendasar.

FileAttributes

Atribut file, yang dapat berupa kombinasi yang valid dari berikut ini:

  • FILE_ATTRIBUTE_READONLY
  • FILE_ATTRIBUTE_HIDDEN
  • FILE_ATTRIBUTE_SYSTEM
  • FILE_ATTRIBUTE_DIRECTORY
  • FILE_ATTRIBUTE_ARCHIVE
  • FILE_ATTRIBUTE_NORMAL
  • FILE_ATTRIBUTE_TEMPORARY
  • FILE_ATTRIBUTE_COMPRESSED

FileNameLength

Menentukan panjang, dalam byte, dari string nama file.

EaSize

Panjang gabungan, dalam byte, dari atribut yang diperluas (EA) untuk file.

ShortNameLength

Menentukan panjang string nama file pendek.

ShortName[12]

String Unicode yang berisi nama pendek (8.3) untuk file.

FileId

Nomor referensi file 8-byte untuk file. Jumlah ini dihasilkan dan ditetapkan ke file oleh sistem file. (Perhatikan bahwa FileId tidak sama dengan "ID objek file" 16-byte yang ditambahkan ke NTFS untuk Microsoft Windows 2000.)

FileName[1]

Menentukan karakter pertama string nama file. Ini diikuti dalam memori oleh sisa string.

Keterangan

Informasi ini dapat dikueri dengan salah satu cara berikut:

  • Panggil ZwQueryDirectoryFile, melewati FileIdBothDirectoryInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_ID_BOTH_DIR_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.

Nomor referensi file, juga disebut ID file, dijamin hanya unik dalam sistem file statis. Mereka tidak dijamin unik dari waktu ke waktu, karena sistem file bebas untuk menggunakannya kembali. Mereka juga tidak dijamin akan tetap konstan. Misalnya, sistem file FAT menghasilkan nomor referensi file untuk file dari offset byte rekaman entri direktori file (DIRENT) pada disk. Defragmentasi dapat mengubah offset byte ini. Dengan demikian nomor referensi file FAT dapat berubah dari waktu ke waktu.

Semua tanggal dan waktu dalam format waktu sistem absolut. Waktu sistem absolut adalah jumlah interval 100 nanodetik sejak awal tahun 1601.

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

Persyaratan

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

Lihat juga

FsRtlNotifyFullChangeDirectory

IRP_MJ_DIRECTORY_CONTROL

ZwQueryDirectoryFile