SetProviderStatusInfo 結構 (timeprov.h)
SetProviderStatusFunc 函式所使用的結構。
語法
typedef struct SetProviderStatusInfo {
TimeProvState tpsCurrentState;
DWORD dwStratum;
LPWSTR wszProvName;
HANDLE hWaitEvent;
SetProviderStatusInfoFreeFunc *pfnFree;
HRESULT *pHr;
DWORD *pdwSysStratum;
} SetProviderStatusInfo;
成員
tpsCurrentState
提供者的新狀態。 這個成員可以是下列其中一個值:
TPC_Error
TPS_Running
dwStratum
提供者的新階層。 使用硬體時鐘 (的計算機,例如 cesium、GPS 或無線電) 保持時間是階層 1。 透過網路將時間與另一部計算機同步處理的計算機是階層 N+1,其中 N 是其同步處理的電腦階層。
wszProvName
提供者的名稱。
hWaitEvent
當作業完成時,要設定為訊號狀態的事件句柄。 若要建立事件物件,請使用 CreateEvent 函式。
如果不需要通知,這個成員可以是 NULL。
pfnFree
SetProviderStatusInfoFreeFunc 函式的指標,可釋放完成時的結構。
pHr
完成時,此成員包含作業的結果。 如果作業成功,結果會S_OK。 否則,結果是 WinError.h 中定義的其中一個錯誤碼。
pdwSysStratum
完成時,此成員會包含新的系統階層。 系統階層是系統上所有時間提供者的最低階層。 如果具有最低階層的時間提供者遞增其階層,這會遞增系統階層。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
標頭 | timeprov.h |