Función PeerGraphConnect (p2p.h)
La función PeerGraphConnect intenta establecer una conexión con un nodo especificado en un gráfico del mismo nivel. Esta función inicia una operación asincrónica. La aplicación que realiza la llamada debe esperar un evento de PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION para determinar si el intento de conexión se realiza correctamente.
Sintaxis
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[in] PPEER_ADDRESS pAddress,
[out] ULONGLONG *pullConnectionId
);
Parámetros
[in] hGraph
Identificador de un gráfico del mismo nivel.
[in] pwzPeerId
Identificador único de un elemento del mismo nivel al que conectarse en pAddress. Especifique NULL para conectarse a cualquier escucha del mismo nivel en una dirección especificada en el mismo gráfico del mismo nivel.
[in] pAddress
Puntero a una estructura de PEER_ADDRESS que identifica un nodo al que se va a conectar.
[out] pullConnectionId
Recibe el puntero a un ULONGLONG que contiene el identificador de conexión. Este identificador se puede usar con las funciones de comunicación directa.
Valor devuelto
Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.
| Código devuelto | Descripción |
|---|---|
|
Uno de los parámetros no es válido. |
|
No hay suficiente memoria para realizar una operación especificada. |
|
Ya existe una conexión vecina a un nodo especificado. |
|
El identificador de un gráfico del mismo nivel no es válido. |
|
Se debe inicializar un grafo con una llamada a PeerGraphStartup antes de usar esta función. |
Requisitos
| 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 |