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

另请参阅

SetProviderStatusFunc

SetProviderStatusInfoFreeFunc