Structure SetProviderStatusInfo (timeprov.h)

Structure utilisée par la fonction SetProviderStatusFunc .

Syntaxe

typedef struct SetProviderStatusInfo {
  TimeProvState                 tpsCurrentState;
  DWORD                         dwStratum;
  LPWSTR                        wszProvName;
  HANDLE                        hWaitEvent;
  SetProviderStatusInfoFreeFunc *pfnFree;
  HRESULT                       *pHr;
  DWORD                         *pdwSysStratum;
} SetProviderStatusInfo;

Membres

tpsCurrentState

Nouvel état du fournisseur. Ce membre peut être l’une des valeurs suivantes :

TPC_Error

TPS_Running

dwStratum

Nouvelle strate du fournisseur. Les ordinateurs qui utilisent une horloge matérielle (comme le césium, le GPS ou la radio) pour conserver l’heure sont de la strate 1. Les ordinateurs qui synchronisent leur temps avec un autre ordinateur sur le réseau sont la strate N+1, où N est la strate de l’ordinateur avec lequel ils se synchronisent.

wszProvName

Nom du fournisseur.

hWaitEvent

Handle d’un événement à définir à l’état signalé une fois l’opération terminée. Pour créer un objet d’événement, utilisez la fonction CreateEvent .

Si la notification n’est pas nécessaire, ce membre peut avoir la valeur NULL.

pfnFree

Pointeur vers une fonction SetProviderStatusInfoFreeFunc qui libère la structure à l’achèvement.

pHr

À l’achèvement, ce membre contient le résultat de l’opération. Si l’opération réussit, le résultat est S_OK. Sinon, le résultat est l’un des codes d’erreur définis dans WinError.h.

pdwSysStratum

À l’achèvement, ce membre contient la nouvelle couche système. La couche système est la couche la plus basse de tous les fournisseurs de temps sur le système. Si le fournisseur de temps avec la couche la plus basse incrémente sa strate, cela incrémente la couche système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
En-tête	timeprov.h

Voir aussi

SetProviderStatusFunc

SetProviderStatusInfoFreeFunc