Fungsi SetLocalTime (sysinfoapi.h)

Artikel
03/02/2024

Mengatur waktu dan tanggal lokal saat ini.

Sintaks

BOOL SetLocalTime(
  [in] const SYSTEMTIME *lpSystemTime
);

Parameter

[in] lpSystemTime

Penunjuk ke struktur SYSTEMTIME yang berisi tanggal dan waktu lokal baru.

Anggota wDayOfWeek dari struktur SYSTEMTIME diabaikan.

Nilai kembali

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

Proses panggilan harus memiliki hak istimewa SE_SYSTEMTIME_NAME. Hak istimewa ini dinonaktifkan secara default. Fungsi SetLocalTime memungkinkan hak istimewa SE_SYSTEMTIME_NAME sebelum mengubah waktu lokal dan menonaktifkan hak istimewa sebelum kembali. Untuk informasi selengkapnya, lihat Menjalankan dengan Hak Istimewa Khusus.

Sistem menggunakan UTC secara internal. Oleh karena itu, ketika Anda memanggil SetLocalTime, sistem menggunakan informasi zona waktu saat ini untuk melakukan konversi, termasuk pengaturan waktu musim panas. Perhatikan bahwa sistem menggunakan pengaturan waktu musim panas dari waktu saat ini, bukan waktu baru yang Anda atur. Oleh karena itu, untuk memastikan hasil yang benar, panggil SetLocalTime untuk kedua kalinya, sekarang panggilan pertama telah memperbarui pengaturan waktu musim panas.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	sysinfoapi.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll