struktur BY_HANDLE_FILE_INFORMATION (fileapi.h)

Berisi informasi yang diambil fungsi GetFileInformationByHandle .

Sintaks

typedef struct _BY_HANDLE_FILE_INFORMATION {
  DWORD    dwFileAttributes;
  FILETIME ftCreationTime;
  FILETIME ftLastAccessTime;
  FILETIME ftLastWriteTime;
  DWORD    dwVolumeSerialNumber;
  DWORD    nFileSizeHigh;
  DWORD    nFileSizeLow;
  DWORD    nNumberOfLinks;
  DWORD    nFileIndexHigh;
  DWORD    nFileIndexLow;
} BY_HANDLE_FILE_INFORMATION, *PBY_HANDLE_FILE_INFORMATION, *LPBY_HANDLE_FILE_INFORMATION;

Anggota

dwFileAttributes

Atribut file. Untuk nilai yang mungkin dan deskripsinya, lihat Konstanta Atribut File.

ftCreationTime

Struktur FILETIME yang menentukan kapan file atau direktori dibuat. Jika sistem file yang mendasar tidak mendukung waktu pembuatan, anggota ini adalah nol (0).

ftLastAccessTime

Struktur FILETIME . Untuk file, struktur menentukan terakhir kali file dibaca dari atau ditulis. Untuk direktori, struktur menentukan kapan direktori dibuat. Untuk file dan direktori, tanggal yang ditentukan sudah benar, tetapi waktu hari selalu diatur ke tengah malam. Jika sistem file yang mendasar tidak mendukung waktu akses terakhir, anggota ini adalah nol (0).

ftLastWriteTime

Struktur FILETIME . Untuk file, struktur menentukan terakhir kali file ditulis. Untuk direktori, struktur menentukan kapan direktori dibuat. Jika sistem file yang mendasar tidak mendukung waktu tulis terakhir, anggota ini adalah nol (0).

dwVolumeSerialNumber

Nomor seri volume yang berisi file.

nFileSizeHigh

Bagian urutan tinggi dari ukuran file.

nFileSizeLow

Bagian berurutan rendah dari ukuran file.

nNumberOfLinks

Jumlah tautan ke file ini. Untuk sistem file FAT, anggota ini selalu 1. Untuk sistem file NTFS, bisa lebih dari 1.

nFileIndexHigh

Bagian urutan tinggi dari pengidentifikasi unik yang terkait dengan file. Untuk informasi selengkapnya, lihat nFileIndexLow.

nFileIndexLow

Bagian urutan rendah dari pengidentifikasi unik yang terkait dengan file.

Pengidentifikasi (bagian rendah dan tinggi) dan nomor seri volume secara unik mengidentifikasi file pada satu komputer. Untuk menentukan apakah dua handel terbuka mewakili file yang sama, gabungkan pengidentifikasi dan nomor seri volume untuk setiap file dan bandingkan.

Sistem file ReFS, yang diperkenalkan dengan Windows Server 2012, mencakup pengidentifikasi file 128-bit. Untuk mengambil pengidentifikasi file 128-bit, gunakan fungsi GetFileInformationByHandleEx dengan FileIdInfo untuk mengambil struktur FILE_ID_INFO . Pengidentifikasi 64-bit dalam struktur ini tidak dijamin unik pada ReFS.

Keterangan

Pengidentifikasi yang disimpan di anggota nFileIndexHigh dan nFileIndexLow disebut ID file. Dukungan untuk ID file adalah file khusus sistem. ID file tidak dijamin unik dari waktu ke waktu, karena sistem file bebas untuk menggunakannya kembali. Dalam beberapa kasus, ID file untuk file dapat berubah dari waktu ke waktu.

Dalam sistem file FAT, ID file dihasilkan dari kluster pertama dari direktori yang berisi dan offset byte dalam direktori entri untuk file. Beberapa produk defragmentasi mengubah offset byte ini. (Defragmentasi dalam kotak Windows tidak.) Dengan demikian, ID file FAT dapat berubah dari waktu ke waktu. Mengganti nama file dalam sistem file FAT juga dapat mengubah ID file, tetapi hanya jika nama file baru lebih panjang dari yang lama.

Dalam sistem file NTFS, file menyimpan ID file yang sama sampai dihapus. Anda dapat mengganti satu file dengan file lain tanpa mengubah ID file dengan menggunakan fungsi ReplaceFile . Namun, ID file dari file pengganti, bukan file yang diganti, dipertahankan sebagai ID file dari file yang dihasilkan.

Tidak semua sistem file dapat merekam pembuatan dan waktu akses terakhir, dan tidak semua sistem file merekamnya dengan cara yang sama. Misalnya, pada sistem file Windows FAT, waktu pembuatan memiliki resolusi 10 milidetik, waktu tulis memiliki resolusi 2 detik, dan waktu akses memiliki resolusi 1 hari (tanggal akses). Pada sistem file NTFS, waktu akses memiliki resolusi 1 jam. Untuk informasi selengkapnya, lihat Waktu File.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	fileapi.h (sertakan Windows.h)

Lihat juga

FILETIME

FILE_ID_INFO

Konstanta Atribut File

GetFileInformationByHandle

GetFileInformationByHandleEx