Fungsi GetFileTime (fileapi.h)

Artikel
08/23/2023

Mengambil tanggal dan waktu file atau direktori dibuat, terakhir diakses, dan terakhir dimodifikasi.

Sintaks

BOOL GetFileTime(
  [in]            HANDLE     hFile,
  [out, optional] LPFILETIME lpCreationTime,
  [out, optional] LPFILETIME lpLastAccessTime,
  [out, optional] LPFILETIME lpLastWriteTime
);

Parameter

[in] hFile

Handel ke file atau direktori yang tanggal dan waktunya akan diambil. Handel harus dibuat menggunakan fungsi CreateFile dengan hak akses GENERIC_READ . Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.

[out, optional] lpCreationTime

Penunjuk ke struktur FILETIME untuk menerima tanggal dan waktu file atau direktori dibuat. Parameter ini bisa NULL jika aplikasi tidak memerlukan informasi ini.

[out, optional] lpLastAccessTime

Penunjuk ke struktur FILETIME untuk menerima tanggal dan waktu file atau direktori terakhir diakses. Waktu akses terakhir mencakup terakhir kali file atau direktori ditulis ke, dibaca dari, atau, dalam kasus file yang dapat dieksekusi, jalankan. Parameter ini bisa NULL jika aplikasi tidak memerlukan informasi ini.

[out, optional] lpLastWriteTime

Penunjuk ke struktur FILETIME untuk menerima tanggal dan waktu file atau direktori terakhir kali ditulis, dipotok, atau ditimpa (misalnya, dengan WriteFile atau SetEndOfFile). Tanggal dan waktu ini tidak diperbarui ketika atribut file atau deskriptor keamanan diubah. Parameter ini bisa NULL jika aplikasi tidak memerlukan informasi ini.

Menampilkan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Tidak semua sistem file dapat merekam pembuatan dan waktu akses terakhir dan tidak semua sistem file merekamnya dengan cara yang sama. Misalnya, pada FAT, waktu pembuatan memiliki resolusi 10 milidetik, waktu tulis memiliki resolusi 2 detik, dan waktu akses memiliki resolusi 1 hari (benar-benar, tanggal akses). Oleh karena itu, fungsi GetFileTime mungkin tidak mengembalikan informasi waktu file yang sama yang ditetapkan menggunakan fungsi SetFileTime .

NTFS menunda pembaruan ke waktu akses terakhir untuk file hingga satu jam setelah akses terakhir. NTFS juga mengizinkan pembaruan waktu akses terakhir dinonaktifkan. Waktu akses terakhir tidak diperbarui pada volume NTFS secara default.

Windows Server 2003 dan Windows XP: Waktu akses terakhir diperbarui pada volume NTFS secara default.

Untuk informasi selengkapnya, lihat Waktu File.

Jika Anda mengganti nama atau menghapus file, maka segera pulihkan setelahnya, Windows mencari cache untuk informasi file yang akan dipulihkan. Informasi yang di-cache mencakup pasangan nama pendek/panjang dan waktu pembuatannya.

Contoh

Misalnya, lihat Mengambil Waktu Last-Write.

Persyaratan


Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	fileapi.h (sertakan Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll