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

完成時，此成員會包含新的系統階層。 系統階層是系統上所有時間提供者的最低階層。 如果具有最低階層的時間提供者遞增其階層，這會遞增系統階層。

規格需求

另請參閱

SetProviderStatusFunc

SetProviderStatusInfoFreeFunc