struktur FILE_BASIC_INFORMATION (wdm.h)

Artikel
08/08/2023

Struktur FILE_BASIC_INFORMATION berisi tanda waktu dan atribut dasar file. Ini digunakan sebagai argumen untuk rutinitas yang mengkueri atau mengatur informasi file.

Sintaks

typedef struct _FILE_BASIC_INFORMATION {
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  ULONG         FileAttributes;
} FILE_BASIC_INFORMATION, *PFILE_BASIC_INFORMATION;

Anggota

CreationTime

Menentukan waktu pembuatan file.

LastAccessTime

Menentukan waktu file terakhir diakses.

LastWriteTime

Menentukan waktu terakhir kali file ditulis.

ChangeTime

Menentukan terakhir kali file diubah.

FileAttributes

Menentukan satu atau beberapa bendera FILE_ATTRIBUTE_XXX . Untuk deskripsi bendera ini, lihat Konstanta Atribut File di Microsoft Windows SDK.

Keterangan

Bendera FILE_ATTRIBUTE_NORMAL tidak dapat diatur atau dikembalikan dalam kombinasi dengan atribut lain. Semua nilai FileAttributes lainnya mengambil alih atribut ini.

Nilai waktu CreationTime, LastAccessTime, LastWriteTime, dan ChangeTime dinyatakan dalam format waktu sistem absolut. Waktu sistem absolut adalah jumlah interval 100-nanodetik sejak awal tahun 1601 di kalender Gregorian.

Jika Anda menentukan nilai nol untuk salah satu anggota XxxTime dari struktur FILE_BASIC_INFORMATION , fungsi ZwSetInformationFile menyimpan pengaturan file saat ini untuk waktu tersebut.

Sistem file memperbarui nilai anggota LastAccessTime, LastWriteTime, dan ChangeTime yang sesuai setelah operasi I/O dilakukan pada file. Driver atau aplikasi dapat meminta agar sistem file tidak memperbarui satu atau beberapa anggota ini untuk operasi I/O yang dilakukan pada handel file penelepon dengan mengatur anggota yang sesuai ke -1. Pemanggil dapat mengatur satu, semua, atau kombinasi lain dari ketiga anggota ini ke -1. Hanya anggota yang diatur ke -1 yang tidak akan terpengaruh oleh operasi I/O pada handel file; anggota lain akan diperbarui sebagaimana mewajarinya. Pada sistem NTFS dan ReFS, pembaruan stempel waktu pada handel file dapat dipulihkan dengan mengatur anggota yang sesuai ke -2.

Untuk mengatur anggota struktur ini, pemanggil harus memiliki akses FILE_WRITE_ATTRIBUTES ke file.