SetProviderStatusInfo-Struktur (timeprov.h)

Eine Struktur, die von der SetProviderStatusFunc-Funktion verwendet wird.

Syntax

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

Member

tpsCurrentState

Der neue Status des Anbieters. Dieser Member kann einer der folgenden Werte sein:

TPC_Error

TPS_Running

dwStratum

Die neue Schicht des Anbieters. Computer, die eine Hardwareuhr (z. B. Cäsium, GPS oder Funk) verwenden, um die Zeit zu halten, sind Stratum 1. Computer, die ihre Zeit mit einem anderen Computer über das Netzwerk synchronisieren, sind Stratum N+1, wobei N die Schicht des Computers ist, mit dem sie synchronisiert werden.

wszProvName

Der Name des Anbieters.

hWaitEvent

Ein Handle für ein Ereignis, das nach Abschluss des Vorgangs auf den Signalzustand festgelegt werden soll. Verwenden Sie die CreateEvent-Funktion , um ein Ereignisobjekt zu erstellen.

Wenn keine Benachrichtigung erforderlich ist, kann dieser Member NULL sein.

pfnFree

Ein Zeiger auf eine SetProviderStatusInfoFreeFunc-Funktion , die die Struktur nach Abschluss freigibt.

pHr

Nach Abschluss des Vorgangs enthält dieser Member das Ergebnis des Vorgangs. Wenn der Vorgang erfolgreich ist, wird das Ergebnis S_OK. Andernfalls ist das Ergebnis einer der in WinError.h definierten Fehlercodes.

pdwSysStratum

Nach Abschluss enthält dieses Element die neue Systemschicht. Die Systemschicht ist die niedrigste Schicht aller Zeitanbieter im System. Wenn der Zeitanbieter mit der niedrigsten Schicht seine Schicht erhöht, wird die Systemschicht erhöht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile timeprov.h

Weitere Informationen

SetProviderStatusFunc

SetProviderStatusInfoFreeFunc