Fungsi SystemTimeToFileTime (timezoneapi.h)

Artikel
03/09/2024

Mengonversi waktu sistem ke format waktu file. Waktu sistem didasarkan pada Waktu Universal Terkoordinasi (UTC).

Sintaks

BOOL SystemTimeToFileTime(
  [in]  const SYSTEMTIME *lpSystemTime,
  [out] LPFILETIME       lpFileTime
);

Parameter

[in] lpSystemTime

Penunjuk ke struktur SYSTEMTIME yang berisi waktu sistem untuk dikonversi dari UTC ke format waktu file.

Anggota wDayOfWeek dari struktur SYSTEMTIME diabaikan.

[out] lpFileTime

Penunjuk ke struktur FILETIME untuk menerima waktu sistem yang dikonversi.

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

Catatan

Nilai pengembalian Salah dapat menunjukkan bahwa struktur SYSTEMTIME yang dilewatkan menunjukkan tanggal yang tidak valid. Situasi tertentu, seperti hari tambahan yang ditambahkan dalam tahun kampung, dapat mengakibatkan logika aplikasi secara tak terduga membuat tanggal yang tidak valid. Untuk informasi selengkapnya tentang menghindari masalah ini, lihat kesiapan tahun kampung.

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]
Target Platform	Windows
Header	timezoneapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll