Partager via


PeerGroupPeerTimeToUniversalTime, fonction (p2p.h)

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