PeerGraphListen, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGraphListen indique qu’un graphe d’homologue doit commencer à écouter les connexions entrantes.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphListen(
  [in] HGRAPH hGraph,
  [in] DWORD  dwScope,
  [in] DWORD  dwScopeId,
  [in] WORD   wPort
);

Paramètres

[in] hGraph

Spécifie le graphique d’homologue sur lequel écouter.

[in] dwScope

Spécifie l’étendue IPv6 sur laquelle écouter. Les valeurs valides sont identifiées dans le tableau suivant. Pour plus d’informations sur l’étendue, consultez Adresses locales et Site-Local.

Valeur	Signification
PEER_GRAPH_SCOPE_GLOBAL	L’étendue inclut Internet.
PEER_GRAPH_SCOPE_SITELOCAL	L’étendue est limitée à un site, par exemple un intranet d’entreprise.
PEER_GRAPH_SCOPE_LINKLOCAL	L’étendue est limitée à un sous-réseau local.

[in] dwScopeId

Spécifie l’ID d’étendue IPv6 sur lequel écouter. Spécifiez zéro (0) pour écouter toutes les interfaces de l’étendue spécifiée.

Note L’ID d’étendue zéro (0) n’est pas autorisé si dwScope est PEER_GRAPH_SCOPE_SITELOCAL ou PEER_GRAPH_SCOPE_LINKLOCAL.

[in] wPort

Spécifie le port sur lequel écouter. Spécifiez zéro (0) pour utiliser un port dynamique. Si zéro (0) est spécifié, utilisez PeerGraphGetNodeInfo pour récupérer des données.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs identifiées dans le tableau suivant.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer l’opération spécifiée.
PEER_E_GRAPH_NOT_READY	Le graphique n’a jamais été synchronisé. Une application ne peut pas écouter tant que le graphe d’homologue n’a pas été synchronisé.
PEER_E_INVALID_GRAPH	Le handle du graphe d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED	Le graphe doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Pour pouvoir accepter des connexions directes, un nœud doit s’abonner à l’événement PEER_GRAPH_EVENT_DIRECT_CONNECTION .

Avant d’appeler cette fonction, l’application doit appeler PeerGraphCreate ou PeerGraphOpen.

Note Si c’est la première fois qu’un graphe d’homologue est ouvert, tous les appels à PeerGraphListen échouent jusqu’à ce que le nœud se connecte au graphe homologue et se synchronise avec celui-ci.

L’application peut spécifier le même ID de port pour différents graphiques homologues, si tous les graphiques homologues sont dans le même processus.

Exemples

L’extrait de code suivant montre comment utiliser la fonction PeerGraphListen .

    // g_hGraph is a handle to the Graph obtained from a previous successful call to PeerGraphCreate or PeerGraphOpen.
    // dwScope should be set to the same scope used to create the graph.  This example assumes the graph was created in the Global scope.
    // g_usPort is the port to use for Graphing.  Use zero to obtain a port dynamically.
    HRESULT hr = PeerGraphListen(g_hGraph, PEER_GRAPH_SCOPE_GLOBAL, 0, g_usPort);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

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