Fungsi SetFileTime (fileapi.h)
Mengatur tanggal dan waktu file atau direktori yang ditentukan dibuat, terakhir diakses, atau terakhir dimodifikasi.
BOOL SetFileTime(
[in] HANDLE hFile,
[in, optional] const FILETIME *lpCreationTime,
[in, optional] const FILETIME *lpLastAccessTime,
[in, optional] const FILETIME *lpLastWriteTime
);
[in] hFile
Handel ke file atau direktori. Handel harus dibuat menggunakan fungsi CreateFile dengan hak akses FILE_WRITE_ATTRIBUTES . Untuk informasi selengkapnya, lihat Keamanan File dan Hak Akses.
[in, optional] lpCreationTime
Penunjuk ke struktur FILETIME yang berisi tanggal dan waktu pembuatan baru untuk file atau direktori. Jika aplikasi tidak perlu mengubah informasi ini, atur parameter ini ke NULL atau ke penunjuk ke struktur FILETIME yang memiliki anggota dwLowDateTime dan dwHighDateTime diatur ke 0.
[in, optional] lpLastAccessTime
Penunjuk ke struktur FILETIME yang berisi tanggal dan waktu akses terakhir baru untuk file atau direktori. Waktu akses terakhir mencakup terakhir kali file atau direktori ditulis ke, dibaca dari, atau (dalam kasus file yang dapat dieksekusi) berjalan. Jika aplikasi tidak perlu mengubah informasi ini, atur parameter ini ke NULL atau ke penunjuk ke struktur FILETIME yang memiliki anggota dwLowDateTime dan dwHighDateTime diatur ke 0.
Untuk mencegah operasi file menggunakan handel yang diberikan dari memodifikasi waktu akses terakhir, panggil SetFileTime segera setelah membuka handel file dan melewati struktur FILETIME yang memiliki anggota dwLowDateTime dan dwHighDateTime diatur ke 0xFFFFFFFF.
[in, optional] lpLastWriteTime
Penunjuk ke struktur FILETIME yang berisi tanggal dan waktu terakhir diubah baru untuk file atau direktori. Jika aplikasi tidak perlu mengubah informasi ini, atur parameter ini ke NULL atau ke penunjuk ke struktur FILETIME yang memiliki anggota dwLowDateTime dan dwHighDateTime diatur ke 0.
Untuk mencegah operasi file menggunakan handel yang diberikan dari memodifikasi waktu tulis terakhir, panggil SetFileTime segera setelah membuka handel file dan melewati struktur FILETIME yang memiliki anggota dwLowDateTime dan dwHighDateTime diatur ke 0xFFFFFFFF.
Jika fungsi berhasil, nilai yang dikembalikan bukan nol.
Jika fungsi gagal, nilai yang dikembalikan adalah nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.
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 SetFileTime. NTFS menunda pembaruan ke waktu akses terakhir untuk file hingga satu jam setelah akses terakhir.
Misalnya, lihat Mengubah Waktu File ke Waktu Saat Ini.
| 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 |