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
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar una operación especificada.
PEER_E_ALREADY_EXISTS	Ya existe una conexión vecina a un nodo especificado.
PEER_E_INVALID_GRAPH	El identificador de un gráfico del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED	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

Consulte también

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData