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