struktur FILE_ID_BOTH_DIR_INFO (winbase.h)

Berisi informasi tentang file dalam direktori yang ditentukan. Digunakan untuk handel direktori. Gunakan hanya saat memanggil GetFileInformationByHandleEx. Jumlah file yang dikembalikan untuk setiap panggilan ke GetFileInformationByHandleEx tergantung pada ukuran buffer yang diteruskan ke fungsi. Setiap panggilan berikutnya ke GetFileInformationByHandleEx pada handel yang sama akan melanjutkan operasi enumerasi setelah file terakhir dikembalikan.

Sintaks

typedef struct _FILE_ID_BOTH_DIR_INFO {
  DWORD         NextEntryOffset;
  DWORD         FileIndex;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER EndOfFile;
  LARGE_INTEGER AllocationSize;
  DWORD         FileAttributes;
  DWORD         FileNameLength;
  DWORD         EaSize;
  CCHAR         ShortNameLength;
  WCHAR         ShortName[12];
  LARGE_INTEGER FileId;
  WCHAR         FileName[1];
} FILE_ID_BOTH_DIR_INFO, *PFILE_ID_BOTH_DIR_INFO;

Anggota

NextEntryOffset

Offset untuk struktur FILE_ID_BOTH_DIR_INFO berikutnya yang dikembalikan. Berisi nol (0) jika tidak ada entri lain yang mengikuti entri 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 pembuatan file.

LastAccessTime

Waktu file terakhir diakses.

LastWriteTime

Waktu terakhir file ditulis.

ChangeTime

Waktu file terakhir diubah.

EndOfFile

Posisi akhir file baru absolut sebagai offset byte dari awal file hingga 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 yang segera mengikuti byte terakhir yang valid dalam file.

AllocationSize

Jumlah byte yang dialokasikan untuk file. Nilai ini biasanya merupakan kelipatan dari sektor atau ukuran kluster dari perangkat fisik yang mendasar.

FileAttributes

Atribut file. Anggota ini dapat menjadi kombinasi yang valid dari atribut berikut:

FILE_ATTRIBUTE_ARCHIVE (0x00000020)

FILE_ATTRIBUTE_COMPRESSED (0x00000800)

FILE_ATTRIBUTE_DIRECTORY (0x00000010)

FILE_ATTRIBUTE_HIDDEN (0x00000002)

FILE_ATTRIBUTE_NORMAL (0x00000080)

FILE_ATTRIBUTE_READONLY (0x00000001)

FILE_ATTRIBUTE_SYSTEM (0x00000004)

FILE_ATTRIBUTE_TEMPORARY (0x00000100)

FileNameLength

Panjang nama file.

EaSize

Ukuran atribut yang diperluas untuk file.

ShortNameLength

Panjang ShortName.

ShortName[12]

Konvensi penamaan file 8.3 pendek (misalnya, nama file "FILENAME.TXT").

FileId

ID file.

FileName[1]

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

Keterangan

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 FILE_ID_BOTH_DIR_INFO ini harus diselaraskan pada batas DWORDLONG (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
Klien minimum yang didukung	Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Header	winbase.h (termasuk Windows.h)
Redistribusi	Windows SDK di Windows Server 2003 dan Windows XP.

Lihat juga

FILE_INFO_BY_HANDLE_CLASS

Konstanta Atribut File

GetFileInformationByHandleEx