PeerGroupPeerTimeToUniversalTime, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGroupPeerTimeToUniversalTime convertit la valeur d’heure de référence gérée par le groupe d’homologues en une valeur de temps localisée appropriée pour l’affichage sur un ordinateur homologue.

Syntaxe

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

Paramètres

[in] hGroup

Gérez le groupe d’homologues auquel participe un homologue. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] pftPeerTime

Pointeur vers la valeur d’heure de l’homologue ( Heure universelle coordonnée (UTC) – qui est représentée sous la forme d’une structure FILETIME . Ce paramètre est obligatoire.

[out] pftUniversalTime

Pointeur vers la valeur de temps universelle retournée qui est représentée sous la forme d’une structure FILETIME . Ce paramètre a la valeur NULL si une erreur se produit.

Valeur retournée

Retourne S_OK si la fonction réussit. Sinon, la fonction retourne l’une des erreurs d’appel de procédure distante (RPC) ou l’une des erreurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
PEER_E_GROUP_NOT_READY	Le groupe d’homologues n’est pas à l’état où l’heure d’homologue peut être récupérée avec précision, par exemple, PeerGroupJoin a été appelé, mais la synchronisation avec la base de données de groupe n’est pas terminée.
PEER_E_NOT_INITIALIZED	Le groupe d’homologues doit être initialisé avec un appel à PeerGroupStartup avant d’utiliser cette fonction.

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont précédées de CRYPT_* et définies dans Winerror.h.

Remarques

Le temps universel est la valeur de temps universelle conservée sur un ordinateur homologue.

L’heure d’homologue est une heure de référence courante gérée par un groupe d’homologues, exprimée en UTC. Il est souvent décalé par rapport à la valeur de temps universel et est utilisé pour corriger les problèmes de latence.

L’heure universelle peut être convertie en heure d’homologue en appelant la fonction converse PeerGroupUniversalTimeToPeerTime.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll

Voir aussi

PeerGroupUniversalTimeToPeerTime

Partager via