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 |