PeerGroupUniversalTimeToPeerTime-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGroupUniversalTimeToPeerTime-Funktion konvertiert einen Ortszeitwert vom Computer eines Peers in einen gemeinsamen Peergruppenzeitwert.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUniversalTimeToPeerTime(
  [in]  HGROUP   hGroup,
  [in]  FILETIME *pftUniversalTime,
  [out] FILETIME *pftPeerTime
);

Parameter

[in] hGroup

Handle mit der Peergruppe, an der ein Peer teilnimmt. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] pftUniversalTime

Zeiger auf den universellen Zeitwert, dargestellt als FILETIME-Struktur . Dieser Parameter ist erforderlich.

[out] pftPeerTime

Zeiger auf die zurückgegebene Peerzeit – Gmt-Wert (Greenwich Mean Time), der als FILETIME-Struktur dargestellt wird. Dieser Parameter ist NULL , wenn ein Fehler auftritt.

Rückgabewert

Gibt S_OK zurück, wenn die Funktion erfolgreich ist. Andernfalls gibt die Funktion entweder einen der RPC-Fehler oder einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
PEER_E_GROUP_NOT_READY	Die Peergruppe befindet sich nicht in einem Zustand, in dem die Peerzeit genau berechnet werden kann. Beispielsweise wurde PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Peergruppendatenbank wurde nicht abgeschlossen.
PEER_E_NOT_INITIALIZED	Die Gruppe muss mit einem Aufruf von PeerGroupStartup initialisiert werden, bevor Sie diese Funktion verwenden.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Universelle Zeit ist der universelle Zeitwert, der auf dem Computer eines Peers verwaltet wird.

Peerzeit ist eine gemeinsame Referenzzeit, die von einer Peergruppe verwaltet wird und als koordinierte Weltzeit (UTC) ausgedrückt wird. Er wird häufig vom universellen Zeitwert versetzt und zum Beheben von Latenzproblemen verwendet.

Peerzeit kann in universelle Zeit konvertiert werden, indem die umgekehrte Funktion PeerGroupPeerTimeToUniversalTime aufgerufen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Erweiterten Netzwerkpaket fürWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

Weitere Informationen

PeerGroupPeerTimeToUniversalTime

Freigeben über