PeerGraphConnect, fonction (p2p.h)

Article
08/25/2023

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
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_ALREADY_EXISTS	Une connexion voisine à un nœud spécifié existe déjà.
PEER_E_INVALID_GRAPH	Le handle d’un graphique d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED	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

Voir aussi

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData

Share via