GetTimeSysInfoFunc 回呼函式 (timeprov.h)
擷取系統時間狀態資訊。
語法
GetTimeSysInfoFunc Gettimesysinfofunc;
HRESULT Gettimesysinfofunc(
[in] TimeSysInfo eInfo,
[out] void *pvInfo
)
{...}
參數
[in] eInfo
要求的狀態資訊。 此參數可以是下列其中一個值。
| 值 |
意義 |
- TSI_ClockPrecision
|
pvInfo 參數是帶正負號的__int32值，指定log2秒的時鐘有效位數。
|
- TSI_ClockTickSize
|
pvInfo 參數是未帶正負號的__int64值，指定時鐘刻度大小， (10^-7) 秒。
|
- TSI_CurrentTime
|
pvInfo 參數是一個不帶正負號的__int64值，指定目前時間， (10^-7) 自上午 12：00 A.M. A.M. 1601 國際標準時間 (UTC) 。
|
- TSI_LastSyncTime
|
pvInfo 參數是一個不帶正負號的__int64值，指定上次同步時間， (10^-7) 秒間隔，自上午 12：00 A.M. 1601 國際標準時間 (UTC) 。
|
- TSI_LeapFlags
|
pvInfo 參數是 BYTE 值，表示即將發生的閏秒或同步處理遺失。 定義下列值：
- 0 - 無變更
- 1 - 新增閏秒
- 2 - 減去閏秒
- 3 - 未同步
|
- TSI_PhaseOffset
|
pvInfo 參數是帶正負號的__int64值，指定用來調整時鐘的階段位移，以秒為單位。
|
- TSI_PollInterval
|
pvInfo 參數是帶正負號的__int32值，指定log2秒中的輪詢間隔。
|
- TSI_ReferenceIdentifier
|
pvInfo 參數是 DWORD 值，以 NTP 格式指定時間來源的參考標識元， (IP 位址或描述硬體來源的四個字元 ASCII 字串，例如全域定位系統 (GPS) 或 WWVB) 。
|
- TSI_RootDelay
|
pvInfo 參數是帶正負號的__int64值，指定根延遲， (10^-7) 秒。
|
- TSI_RootDispersion
|
pvInfo 參數是一個不帶正負號的__int64值，指定 (10^-7) 秒的根樹狀結構。
|
- TSI_Stratum
|
pvInfo 參數是 BYTE 值，指定將此電腦與根來源分開的網路躍點數目。 硬體提供者應該傳回零。 NTP 提供者應該傳回提供範例的對等階層。
|
- TSI_TickCount
|
pvInfo 參數是未帶正負號的__int64值，指定自系統啟動) 以來的刻度計數 (毫秒數。 此值最終會換行，因此應該只用來比較簡短的間隔。
|
- TSI_TSFlags
|
pvInfo 參數是 DWORD 值，指定下列其中一個時間來源旗標：
- TSF_Authenticated
- TSF_Hardware
- TSF_IPv6
|
[out] pvInfo
接收該狀態信息的緩衝區指標。 此數據的格式取決於 eInfo 的值。
傳回值
如果函式成功，傳回值會S_OK。 否則，傳回值是 WinError.h 中定義的其中一個錯誤碼。
為了確保正確性，時間提供者應該使用 GetTimeSysInfoFunc 擷取所有時間相關信息。 請注意，時間值不應該直接在 NTP 封包中使用。 它們會以 12：00 A.M.A.M.1601 表示，而 NTP 會指定時間值相對於 12：00 A.M.M. 1900 年 1 月 1 日表示。
TimeProvOpen 函式會傳回此函式的指標。
範例
如需範例，請參閱 範例時間提供者。
規格需求
| 需求 |
值 |
| 最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 |
Windows |
| 標頭 |
timeprov.h |