PeerGroupUniversalTimeToPeerTime, fonction (p2p.h)

  • Article

La fonction PeerGroupUniversalTimeToPeerTime convertit une valeur d’heure locale de l’ordinateur d’un homologue en une valeur de temps de groupe d’homologues commune.

Syntaxe

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

Paramètres

[in] hGroup

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

[in] pftUniversalTime

Pointeur vers la valeur de temps universelle, représentée sous la forme d’une structure FILETIME . Ce paramètre est obligatoire.

[out] pftPeerTime

Pointeur vers l’heure d’homologue retournée : valeur GMT (Greenwich Mean Time) 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 RPC ou l’une des valeurs 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 dans un état où l’heure d’homologue peut être calculée avec précision. Par exemple, PeerGroupJoin a été appelé, mais la synchronisation avec la base de données du groupe d’homologues n’est pas terminée.
PEER_E_NOT_INITIALIZED
 Le groupe 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éfixées par CRYPT_* et définies dans Winerror.h.

Remarques

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

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

L’heure homologue peut être convertie en temps universel en appelant la fonction inverse PeerGroupPeerTimeToUniversalTime.

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 de mise en réseau avancé pour Windows 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

PeerGroupPeerTimeToUniversalTime