PeerGroupPeerTimeToUniversalTime-Funktion (p2p.h)

Artikel
03/01/2024

Die PeerGroupPeerTimeToUniversalTime-Funktion konvertiert den von peergruppen verwalteten Referenzzeitwert in einen lokalisierten Zeitwert, der für die Anzeige auf einem Peercomputer geeignet ist.

Syntax

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

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] pftPeerTime

Zeiger auf den Peerzeitwert (Coordinated Universal Time, UTC), der als FILETIME-Struktur dargestellt wird. Dieser Parameter ist erforderlich.

[out] pftUniversalTime

Zeiger auf den zurückgegebenen universellen Zeitwert, 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 (Remote Procedure Call) oder einen der folgenden Fehler 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 abgerufen werden kann, z. B. wurde PeerGroupJoin aufgerufen, aber die Synchronisierung mit der Gruppendatenbank wurde noch nicht abgeschlossen.
PEER_E_NOT_INITIALIZED	Die Peergruppe 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 einem Peercomputer verwaltet wird.

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

Universelle Zeit kann in Peerzeit konvertiert werden, indem die umgekehrte Funktion PeerGroupUniversalTimeToPeerTime 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

PeerGroupUniversalTimeToPeerTime

Freigeben über