Struktur FILETIME (minwinbase.h)

Artikel
03/08/2023

Berisi nilai 64-bit yang menunjukkan jumlah interval 100 nanodetik sejak 1 Januari 1601 (UTC).

Sintaks

typedef struct _FILETIME {
  DWORD dwLowDateTime;
  DWORD dwHighDateTime;
} FILETIME, *PFILETIME, *LPFILETIME;

Anggota

dwLowDateTime

Bagian berurutan rendah dari waktu file.

dwHighDateTime

Bagian urutan tinggi dari waktu file.

Keterangan

Untuk mengonversi struktur FILETIME menjadi waktu yang mudah ditampilkan kepada pengguna, gunakan fungsi FileTimeToSystemTime .

Tidak disarankan agar Anda menambahkan dan mengurangi nilai dari struktur FILETIME untuk mendapatkan waktu relatif. Sebagai gantinya, Anda harus menyalin bagian rendah dan berurutan tinggi dari waktu file ke struktur ULARGE_INTEGER , melakukan aritmatika 64-bit pada anggota QuadPart , dan menyalin anggota LowPart dan HighPart ke dalam struktur FILETIME .

Jangan mentransmisikan penunjuk ke struktur FILETIME ke nilai ULARGE_INTEGER* atau __int64* karena dapat menyebabkan kesalahan perataan pada Windows 64-bit.

Tidak semua sistem file dapat merekam pembuatan dan waktu akses terakhir dan tidak semua sistem file merekamnya dengan cara yang sama. Misalnya, pada NT FAT, waktu buat memiliki resolusi 10 milidetik, waktu tulis memiliki resolusi 2 detik, dan waktu akses memiliki resolusi 1 hari (benar-benar, tanggal akses). Pada NTFS, waktu akses memiliki resolusi 1 jam. Oleh karena itu, fungsi GetFileTime mungkin tidak mengembalikan informasi waktu file yang sama yang ditetapkan menggunakan fungsi SetFileTime . Selain itu, FAT merekam waktu pada disk di waktu setempat. Namun, NTFS mencatat waktu pada disk di UTC. Untuk informasi selengkapnya, lihat Waktu File.

Fungsi yang menggunakan struktur FILETIME dapat memungkinkan nilai di luar nol atau nilai positif yang biasanya ditentukan oleh anggota dwLowDateTime dan dwHighDateTime . Misalnya, fungsi SetFileTime menggunakan 0xFFFFFFFF untuk menentukan bahwa waktu akses file sebelumnya harus dipertahankan. Untuk informasi selengkapnya, lihat topik untuk fungsi yang Anda panggil.

Contoh

Misalnya, lihat Mengubah Waktu File ke Waktu Saat Ini atau Mengambil Waktu Last-Write.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop \| Aplikasi UWP]
Header	minwinbase.h (termasuk Windows.h)

Lihat juga