Funzione PeerGraphListen (p2p.h)
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.
[in] dwScopeId
Specifica l'ID ambito IPv6 da ascoltare. Specificare zero (0) per ascoltare tutte le interfacce dell'ambito specificato.
[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 |
---|---|
|
Uno dei parametri non è valido. |
|
Memoria insufficiente per eseguire l'operazione specificata. |
|
Il grafico non è mai stato sincronizzato. Un'applicazione non può essere in ascolto fino a quando il grafico peer non è stato sincronizzato. |
|
L'handle al grafico peer non è valido. |
|
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.
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 |