Fungsi GetSystemTimeAdjustment (sysinfoapi.h)

Menentukan apakah sistem menerapkan penyesuaian waktu berkala pada waktunya, dan mendapatkan nilai dan periode penyesuaian tersebut.

Sintaks

BOOL GetSystemTimeAdjustment(
  [out] PDWORD lpTimeAdjustment,
  [out] PDWORD lpTimeIncrement,
  [out] PBOOL  lpTimeAdjustmentDisabled
);

Parameter

[out] lpTimeAdjustment

Pointer ke variabel yang diatur fungsi ke jumlah unit lpTimeIncrement 100-nanosecond yang ditambahkan ke jam time-of-day untuk setiap periode waktu yang benar-benar berlalu sebagaimana dihitung oleh sistem. Nilai ini hanya memiliki arti jika lpTimeAdjustmentDisabled adalah FALSE.

[out] lpTimeIncrement

Penunjuk ke variabel yang diatur fungsi ke interval dalam unit 100 nanodetik di mana sistem akan menambahkan lpTimeAdjustment ke jam waktu sehari. Nilai ini hanya memiliki arti jika lpTimeAdjustmentDisabled adalah FALSE.

[out] lpTimeAdjustmentDisabled

Penunjuk ke variabel yang diatur fungsi untuk menunjukkan apakah penyesuaian waktu berkala berlaku.

Nilai TRUE menunjukkan bahwa penyesuaian waktu berkala dinonaktifkan, dan waktu sistem dari jam sehari maju pada tingkat normal. Dalam mode ini, sistem dapat menyesuaikan waktu hari menggunakan mekanisme sinkronisasi waktu internalnya sendiri. Mekanisme sinkronisasi waktu internal ini dapat menyebabkan jam waktu sehari berubah selama operasi sistem normal, yang dapat mencakup lompatan waktu yang nyata seperti yang dianggap perlu oleh sistem.

Nilai FALSE menunjukkan bahwa penyesuaian waktu berkala sedang digunakan untuk menyesuaikan jam waktu sehari. Untuk setiap periode waktu lpTimeIncrement yang benar-benar berlalu, lpTimeAdjustment akan ditambahkan ke waktu dalam sehari. Jika nilai lpTimeAdjustment lebih kecil dari lpTimeIncrement, jam waktu hari sistem akan maju pada tingkat yang lebih lambat dari biasanya. Jika nilai lpTimeAdjustment lebih besar dari lpTimeIncrement, jam waktu sehari akan maju pada tingkat yang lebih cepat dari biasanya. Jika lpTimeAdjustment sama dengan lpTimeIncrement, jam waktu sehari akan maju pada kecepatan normalnya. Nilai lpTimeAdjustment dapat diatur dengan memanggil SetSystemTimeAdjustment. Nilai lpTimeIncrement diperbaiki oleh sistem saat dimulai, dan tidak berubah selama operasi sistem. Dalam mode ini, sistem tidak akan mengganggu skema penyesuaian waktu, dan tidak akan mencoba menyinkronkan waktu hari sendiri melalui teknik lain.

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

Fungsi GetSystemTimeAdjustment dan SetSystemTimeAdjustment dapat digunakan untuk mendukung algoritma yang ingin menyinkronkan jam waktu sehari, yang dilaporkan oleh GetSystemTime dan GetLocalTime, dengan sumber waktu lain dengan menggunakan penyesuaian waktu berkala.

Fungsi GetSystemTimeAdjustment memungkinkan pemanggil menentukan apakah penyesuaian waktu berkala diaktifkan, dan jika ya, mendapatkan jumlah setiap penyesuaian dan waktu antara penyesuaian. Fungsi SetSystemTimeAdjustment memungkinkan penelepon mengaktifkan atau menonaktifkan penyesuaian waktu berkala, dan mengatur nilai kenaikan penyesuaian.

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

Lihat juga

GetLocalTime

GetSystemTime

SetSystemTimeAdjustment

Waktu Sistem

Fungsi Waktu