struktur FILE_STAT_BASIC_INFORMATION (ntifs.h)

Penting

Beberapa informasi berkaitan dengan produk prarilis yang mungkin dimodifikasi secara substansial sebelum dirilis secara komersial. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

FILE_STAT_BASIC_INFORMATION berisi metadata dasar tentang file.

Sintaks

typedef struct _FILE_STAT_BASIC_INFORMATION {
  LARGE_INTEGER FileId;
  LARGE_INTEGER CreationTime;
  LARGE_INTEGER LastAccessTime;
  LARGE_INTEGER LastWriteTime;
  LARGE_INTEGER ChangeTime;
  LARGE_INTEGER AllocationSize;
  LARGE_INTEGER EndOfFile;
  ULONG         FileAttributes;
  ULONG         ReparseTag;
  ULONG         NumberOfLinks;
  ULONG         DeviceType;
  ULONG         DeviceCharacteristics;
  ULONG         Reserved;
  LARGE_INTEGER VolumeSerialNumber;
  FILE_ID_128   FileId128;
} FILE_STAT_BASIC_INFORMATION, *PFILE_STAT_BASIC_INFORMATION;

Anggota

FileId

Menentukan id file.

CreationTime

Menentukan waktu pembuatan file.

LastAccessTime

Menentukan terakhir kali file diakses.

LastWriteTime

Menentukan terakhir kali file ditulis.

ChangeTime

Menentukan terakhir kali file diubah.

AllocationSize

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

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.

FileAttributes

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

Atribut	Nilai
FILE_ATTRIBUTE_READONLY	0x00000001
FILE_ATTRIBUTE_HIDDEN	0x00000002
FILE_ATTRIBUTE_SYSTEM	0x00000004
FILE_ATTRIBUTE_DIRECTORY	0x00000010
FILE_ATTRIBUTE_ARCHIVE	0x00000020
FILE_ATTRIBUTE_NORMAL	0x00000080

ReparseTag

Tag titik pemilah ulang. Lihat Tentang titik pemilah ulang untuk informasi selengkapnya.

NumberOfLinks

Menentukan jumlah tautan ke file.

DeviceType

Atur saat driver memanggil IoCreateDevice yang sesuai untuk jenis perangkat yang mendasar. Untuk informasi selengkapnya, lihat Menentukan Jenis Perangkat.

DeviceCharacteristics

Karakteristik perangkat. Untuk deskripsi nilai yang relevan, lihat DEVICE_OBJECT.

Reserved

Dicadangkan untuk penggunaan sistem.

VolumeSerialNumber

Nomor seri volume tempat file berada.

FileId128

Nomor referensi file 128-byte untuk file. Jumlah ini dihasilkan dan ditetapkan ke file oleh sistem file.

Keterangan

Informasi ini dapat dikueri dengan salah satu cara berikut:

• Panggil ZwQueryDirectoryFile, meneruskan FileStatBasicInformation sebagai nilai FileInformationClass dan melewati buffer yang dialokasikan pemanggil, FILE_ID_EXTD_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
Klien minimum yang didukung	Windows 11, versi 24H2
Header	ntifs.h

Lihat juga

FILE_INFORMATION_CLASS

**ZwQueryInformationByName **