PeerGroupConnect, fonction (p2p.h)

La fonction PeerGroupConnect lance une recherche PNRP pour un groupe d’homologues et tente de s’y connecter. Une fois cette fonction appelée avec succès, un homologue peut communiquer avec d’autres membres du groupe d’homologues.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

Paramètres

[in] hGroup

Gérez le groupe d’homologues auquel un homologue a l’intention de se connecter. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen, PeerGroupJoin ou PeerGroupPasswordJoin . Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne la valeur suivante.

Code de retour	Description
PEER_E_INVALID_GROUP	Le handle du groupe d’homologues n’est pas valide.

 

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

Une application s’inscrit pour les événements homologues avant d’appeler cette fonction. Si l’appel de fonction échoue, un événement PEER_GROUP_EVENT_CONNECTION_FAILED est déclenché. Sinon, un événement PEER_GROUP_EVENT_STATUS_CHANGED est déclenché.

L’événement PEER_GROUP_EVENT_CONNECTION_FAILED est également déclenché lorsqu’un créateur de groupe ne parvient pas à appeler PeerGroupConnect immédiatement après sa création. Si ce n’est pas le cas, les utilisateurs invités appellent PeerGroupConnect correctement, mais ils ne pourront pas écouter et recevront l’événement d’échec de connexion.

En cas d’asymétrie d’horloge entre les machines participantes, la réussite de PeerGroupConnect peut dépendre de la gravité de l’asymétrie. Lors de la résolution d’un échec de jointure, cette possibilité doit être prise en considération en vérifiant que les horloges de l’ordinateur sont synchronisées.

Pour être présent dans le groupe d’homologues et recevoir des événements, mais ne pas être connecté, utilisez la fonction PeerGroupOpen .

Si aucune valeur de délai d’attente pour PeerGroupConnect n’est fournie dans l’application, un échec entraîne le blocage de l’application. Une valeur de délai d’attente de 30 secondes est recommandée.

Avant d’appeler PeerGroupConnect, un groupe existe dans un « état déconnecté ». Pendant ce temps, le groupe ne peut pas être détecté ou recevoir des connexions. Pour retourner un groupe à cet état, la fonction PeerGroupClose doit être appelée.

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

PeerGroupClose

PeerGroupJoin

PeerGroupOpen

PeerGroupPasswordJoin