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) |