Funzione PeerGraphListen (p2p.h)

Articolo
03/15/2023

La funzione PeerGraphListen indica che un grafico peer deve iniziare ad ascoltare le connessioni in ingresso.

Sintassi

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

Parametri

[in] hGraph

Specifica il grafico peer su cui eseguire l'ascolto.

[in] dwScope

Specifica l'ambito IPv6 da ascoltare. I valori validi vengono identificati nella tabella seguente. Per altre informazioni sull'ambito, vedere Link-Local e Site-Local Addresses.

Valore	Significato
PEER_GRAPH_SCOPE_GLOBAL	L'ambito include Internet.
PEER_GRAPH_SCOPE_SITELOCAL	L'ambito è limitato a un sito, ad esempio una intranet aziendale.
PEER_GRAPH_SCOPE_LINKLOCAL	L'ambito è limitato a una subnet locale.

[in] dwScopeId

Specifica l'ID ambito IPv6 da ascoltare. Specificare zero (0) per ascoltare tutte le interfacce dell'ambito specificato.

Nota L'ID ambito zero (0) non è consentito se dwScope è PEER_GRAPH_SCOPE_SITELOCAL o PEER_GRAPH_SCOPE_LINKLOCAL.

[in] wPort

Specifica la porta su cui eseguire l'ascolto. Specificare zero (0) per usare una porta dinamica. Se viene specificato zero (0), usare PeerGraphGetNodeInfo per recuperare i dati.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori identificati nella tabella seguente.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_GRAPH_NOT_READY	Il grafico non è mai stato sincronizzato. Un'applicazione non può essere in ascolto fino a quando il grafico peer non è stato sincronizzato.
PEER_E_INVALID_GRAPH	L'handle al grafico peer non è valido.
PEER_E_NOT_INITIALIZED	Il grafico deve essere inizializzato con una chiamata a PeerGraphStartup, prima di usare questa funzione.

Commenti

Per accettare connessioni dirette, un nodo deve sottoscrivere l'evento PEER_GRAPH_EVENT_DIRECT_CONNECTION .

Prima di poter chiamare questa funzione, l'applicazione deve chiamare PeerGraphCreate o PeerGraphOpen.

Nota Se si tratta della prima apertura di un grafico peer, tutte le chiamate a PeerGraphListen non riescono fino a quando il nodo si connette e si sincronizza con il grafico peer.

L'applicazione può specificare lo stesso ID porta per grafici peer diversi, se tutti i grafici peer si trovano nello stesso processo.

Esempio

Il frammento di codice seguente illustra come usare la funzione 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.
    }

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll

Vedi anche

Condividi tramite