Fungsi panggilan balik GetTimeSysInfoFunc (timeprov.h)

Artikel
08/26/2023

Mengambil informasi status waktu sistem.

Sintaks

GetTimeSysInfoFunc Gettimesysinfofunc;

HRESULT Gettimesysinfofunc(
  [in]  TimeSysInfo eInfo,
  [out] void *pvInfo
)
{...}

Parameter

[in] eInfo

Informasi status yang diminta. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
TSI_ClockPrecision	Parameter pvInfo adalah nilai __int32 yang ditandatangani yang menentukan presisi jam, dalam log2 detik.
TSI_ClockTickSize	Parameter pvInfo adalah nilai __int64 yang tidak ditandatangani yang menentukan ukuran centang jam, dalam (10^-7) detik.
TSI_CurrentTime	Parameter pvInfo adalah nilai __int64 yang tidak ditandatangani yang menentukan waktu saat ini, dalam interval (10^-7) detik yang telah berlalu sejak 12:00 A.M. 1 Januari 1601 Waktu Universal Terkoordinasi (UTC).
TSI_LastSyncTime	Parameter pvInfo adalah nilai __int64 yang tidak ditandatangani yang menentukan waktu sinkronisasi terakhir, dalam interval (10^-7) detik yang telah berlalu sejak 12:00 A.M. 1 Januari 1601 Waktu Universal Terkoordinasi (UTC).
TSI_LeapFlags	Parameter pvInfo adalah nilai BYTE yang menunjukkan lompatan kedua yang akan tiba atau hilangnya sinkronisasi. Nilai berikut didefinisikan: 0 - Tidak ada perubahan 1 - Tambahkan lompatan kedua 2 - Kurangi lompatan kedua 3 - Tidak disinkronkan
TSI_PhaseOffset	Parameter pvInfo adalah nilai __int64 yang ditandatangani yang menentukan offset fase yang digunakan untuk menyesuaikan jam, dalam hitungan detik.
TSI_PollInterval	Parameter pvInfo adalah nilai __int32 yang ditandatangani yang menentukan interval polling, dalam log2 detik.
TSI_ReferenceIdentifier	Parameter pvInfo adalah nilai DWORD yang menentukan pengidentifikasi referensi untuk sumber waktu, dalam format NTP (baik alamat IP atau string ASCII empat karakter yang menjelaskan sumber perangkat keras, seperti Global Positioning System (GPS) atau WWVB).
TSI_RootDelay	Parameter pvInfo adalah nilai __int64 yang ditandatangani yang menentukan penundaan akar, dalam (10^-7) detik.
TSI_RootDispersion	Parameter pvInfo adalah nilai __int64 yang tidak ditandatangani yang menentukan, dispersi akar, dalam (10^-7) detik.
TSI_Stratum	Parameter pvInfo adalah nilai BYTE yang menentukan jumlah hop jaringan yang memisahkan komputer ini dari sumber akar. Penyedia perangkat keras harus mengembalikan nol. Penyedia NTP harus mengembalikan stratum serekan yang menyediakan sampel.
TSI_TickCount	Parameter pvInfo adalah nilai __int64 yang tidak ditandatangani yang menentukan jumlah centang (jumlah milidetik sejak sistem dimulai). Nilai ini pada akhirnya akan dibungkus, sehingga harus digunakan hanya untuk membandingkan interval pendek.
TSI_TSFlags	Parameter pvInfo adalah nilai DWORD yang menentukan salah satu bendera sumber waktu berikut: TSF_Authenticated TSF_Hardware TSF_IPv6

[out] pvInfo

Penunjuk ke buffer yang menerima informasi status tersebut. Format data ini tergantung pada nilai eInfo.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan S_OK. Jika tidak, nilai yang dikembalikan adalah salah satu kode kesalahan yang ditentukan dalam WinError.h.

Keterangan

Untuk memastikan akurasi, penyedia waktu harus mengambil semua informasi terkait waktu menggunakan GetTimeSysInfoFunc. Perhatikan bahwa nilai waktu tidak boleh digunakan langsung dalam paket NTP. Mereka dinyatakan relatif terhadap 12:00 A.M. 1 Januari 1601, sedangkan NTP menentukan bahwa nilai waktu dinyatakan relatif terhadap 12:00 A.M. 1 Januari 1900.

Fungsi TimeProvOpen mengembalikan penunjuk ke fungsi ini.

Contoh

Misalnya, lihat Penyedia Waktu Sampel.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	timeprov.h

Bagikan melalui