Función PeerGraphListen (p2p.h)

La función PeerGraphListen indica que un gráfico del mismo nivel debe empezar a escuchar las conexiones entrantes.

Sintaxis

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

Parámetros

[in] hGraph

Especifica el gráfico del mismo nivel en el que se va a escuchar.

[in] dwScope

Especifica el ámbito IPv6 en el que se va a escuchar. Los valores válidos se identifican en la tabla siguiente. Para obtener más información sobre el ámbito, vea Link-Local y Site-Local Addresses.

Valor	Significado
PEER_GRAPH_SCOPE_GLOBAL	El ámbito incluye Internet.
PEER_GRAPH_SCOPE_SITELOCAL	El ámbito está restringido a un sitio, por ejemplo, una intranet corporativa.
PEER_GRAPH_SCOPE_LINKLOCAL	El ámbito está restringido a una subred local.

[in] dwScopeId

Especifica el identificador de ámbito IPv6 en el que se va a escuchar. Especifique cero (0) para escuchar en todas las interfaces del ámbito especificado.

Nota No se permite el identificador de ámbito (0) si dwScope está PEER_GRAPH_SCOPE_SITELOCAL o PEER_GRAPH_SCOPE_LINKLOCAL.

 

[in] wPort

Especifica el puerto en el que se va a escuchar. Especifique cero (0) para usar un puerto dinámico. Si se especifica cero (0), use PeerGraphGetNodeInfo para recuperar datos.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve uno de los valores identificados en la tabla siguiente.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar la operación especificada.
PEER_E_GRAPH_NOT_READY	El gráfico nunca se ha sincronizado. Una aplicación no puede escuchar hasta que se haya sincronizado el grafo del mismo nivel.
PEER_E_INVALID_GRAPH	El identificador del grafo del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED	El gráfico debe inicializarse con una llamada a PeerGraphStartup antes de usar esta función.

Comentarios

Para poder aceptar conexiones directas, un nodo debe suscribirse al evento PEER_GRAPH_EVENT_DIRECT_CONNECTION .

Para poder llamar a esta función, la aplicación debe llamar a PeerGraphCreate o PeerGraphOpen.

Nota Si es la primera vez que se abre un gráfico del mismo nivel, todas las llamadas a PeerGraphListen producirán un error hasta que el nodo se conecte y se sincronice con el gráfico del mismo nivel.

 

La aplicación puede especificar el mismo identificador de puerto para distintos gráficos del mismo nivel, si todos los gráficos del mismo nivel están en el mismo proceso.

Ejemplos

En el fragmento de código siguiente se muestra cómo usar la función 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.
    }

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2PGraph.lib
Archivo DLL	P2PGraph.dll

Consulte también

PeerGraphConnect

PeerGraphCreate

PeerGraphGetNodeInfo

PeerGraphOpen