Fungsi SetFileTime (fileapi.h)

Artikel
08/23/2023

Mengatur tanggal dan waktu file atau direktori yang ditentukan dibuat, terakhir diakses, atau terakhir dimodifikasi.

Sintaks

BOOL SetFileTime(
  [in]           HANDLE         hFile,
  [in, optional] const FILETIME *lpCreationTime,
  [in, optional] const FILETIME *lpLastAccessTime,
  [in, optional] const FILETIME *lpLastWriteTime
);

Parameter

[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.

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 SetFileTime. NTFS menunda pembaruan ke waktu akses terakhir untuk file hingga satu jam setelah akses terakhir.

Contoh

Misalnya, lihat Mengubah Waktu File ke Waktu Saat Ini.

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