struktur FILE_FULL_DIR_INFO (winbase.h)

Berisi informasi direktori untuk file. Struktur ini dikembalikan dari fungsi GetFileInformationByHandleEx ketika FileFullDirectoryInfo atau FileFullDirectoryRestartInfo diteruskan dalam parameter FileInformationClass .

Sintaks

typedef struct _FILE_FULL_DIR_INFO {
  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;
  WCHAR         FileName[1];
} FILE_FULL_DIR_INFO, *PFILE_FULL_DIR_INFO;

Anggota

NextEntryOffset

Offset untuk struktur FILE_FULL_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 pengurutan.

CreationTime

Waktu file dibuat.

LastAccessTime

Waktu file terakhir diakses.

LastWriteTime

Waktu file terakhir ditulis.

ChangeTime

Waktu file terakhir diubah.

EndOfFile

Posisi akhir file baru absolut sebagai offset byte dari awal file ke akhir aliran data default 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 sektor atau ukuran kluster dari perangkat fisik yang mendasar.

FileAttributes

Atribut file. Anggota ini dapat berupa 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.

FileName[1]

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

Keterangan

Struktur FILE_FULL_DIR_INFO adalah subset informasi dalam struktur FILE_ID_BOTH_DIR_INFO . Jika informasi tambahan tidak diperlukan, operasi akan lebih cepat karena berasal dari entri direktori; FILE_ID_BOTH_DIR_INFO berisi informasi dari entri direktori dan Tabel File Master (MFT).

Tidak diperlukan hak akses khusus untuk mengkueri informasi ini.

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

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

Untuk mengkompilasi aplikasi yang menggunakan struktur ini, tentukan makro _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Persyaratan

Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Header	winbase.h (termasuk Windows.h)

Lihat juga

FILE_INFO_BY_HANDLE_CLASS

Struktur Manajemen File

GetFileInformationByHandleEx