PeerGraphConnect, fonction (p2p.h)
La fonction PeerGraphConnect tente d’établir une connexion à un nœud spécifié dans un graphique homologue. Cette fonction démarre une opération asynchrone. L’application appelante doit attendre qu’un événement PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION détermine si la tentative de connexion a réussi.
Syntaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
Paramètres
[in] hGraph
Gérer vers un graphique d’homologue.
[in] pwzPeerId
ID unique d’un homologue auquel se connecter sur pAddress. Spécifiez NULL pour se connecter à n’importe quel homologue qui écoute à une adresse spécifiée dans le même graphique homologue.
[in] pAddress
Pointeur vers une structure PEER_ADDRESS qui identifie un nœud auquel se connecter.
[out] pullConnectionId
Reçoit le pointeur vers un ULONGLONG qui contient l’ID de connexion. Cet ID peut être utilisé avec les fonctions de communication directe.
Valeur retournée
Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.
| Code de retour | Description |
|---|---|
|
L’un des paramètres n’est pas valide. |
|
La mémoire est insuffisante pour effectuer une opération spécifiée. |
|
Une connexion voisine à un nœud spécifié existe déjà. |
|
Le handle d’un graphique d’homologue n’est pas valide. |
|
Un graphique doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction. |
Spécifications
| 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 | P2PGraph.lib |
| DLL | P2PGraph.dll |