Función PeerGraphOpenDirectConnection (p2p.h)

La función PeerGraphOpenDirectConnection permite a una aplicación establecer una conexión directa con un nodo en un gráfico del mismo nivel. La conexión solo se puede realizar si el nodo al que se conecta la aplicación se ha suscrito al evento PEER_GRAPH_EVENT_DIRECT_CONNECTION . Después, la aplicación puede enviar datos directamente a otro nodo. Una llamada a esta función es asincrónica.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphOpenDirectConnection(
  [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

Puntero al identificador único de un usuario o nodo al que conectarse. Este parámetro se usa para identificar un usuario específico porque se pueden adjuntar varias identidades a la dirección especificada.

[in] pAddress

Puntero a una estructura de PEER_ADDRESS que contiene la dirección del nodo al que se va a conectar.

[out] pullConnectionId

Recibe el identificador de conexión de la conexión solicitada.

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
PEER_E_INVALID_GRAPH	El identificador del grafo 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

Una llamada a PeerGraphOpenDirectConnection es una llamada asincrónica. Se desencadena un evento de PEER_GRAPH_EVENT_DIRECT_CONNECTION para informar a la aplicación del éxito o error de la conexión directa. El estado real del éxito o error de la función se da en la estructura PEER_GRAPH_EVENT_DATA .

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

PEER_ADDRESS

PeerGraphCloseDirectConnection

PeerGraphEnumConnections