PeerGraphOpenDirectConnection, fonction (p2p.h)

Article
03/01/2024

La fonction PeerGraphOpenDirectConnection permet à une application d’établir une connexion directe avec un nœud dans un graphique homologue. La connexion ne peut être établie que si le nœud auquel l’application se connecte est abonné à l’événement PEER_GRAPH_EVENT_DIRECT_CONNECTION . L’application peut ensuite envoyer des données directement à un autre nœud. Un appel à cette fonction est asynchrone.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpenDirectConnection(
  [in]  HGRAPH        hGraph,
  [in]  PCWSTR        pwzPeerId,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Paramètres

[in] hGraph

Gérer vers un graphe d’homologue.

[in] pwzPeerId

Pointeur vers l’ID unique d’un utilisateur ou d’un nœud auquel se connecter. Ce paramètre est utilisé pour identifier un utilisateur spécifique, car plusieurs identités peuvent être attachées à l’adresse spécifiée.

[in] pAddress

Pointeur vers une structure PEER_ADDRESS qui contient l’adresse du nœud auquel se connecter.

[out] pullConnectionId

Reçoit l’ID de connexion pour la connexion demandée.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il retourne l’une des valeurs suivantes.

Code de retour	Description
PEER_E_INVALID_GRAPH	Le handle du graphique n’est pas valide.
PEER_E_NOT_INITIALIZED	Le graphe doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Un appel à PeerGraphOpenDirectConnection est un appel asynchrone. Un événement PEER_GRAPH_EVENT_DIRECT_CONNECTION est déclenché pour informer l’application de la réussite ou de l’échec de la connexion directe. La status réelle de la réussite ou de l’échec de la fonction est donnée dans la structure PEER_GRAPH_EVENT_DATA.

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 réseau avancé pourWindows 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

PeerGraphCloseDirectConnection

PeerGraphEnumConnections

Partager via