通过

peerGraphConnect 函数 (p2p.h)

  • 项目

PeerGraphConnect 函数尝试与对等图中的指定节点建立连接。 此函数启动异步操作。 调用应用程序必须等待 PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION 事件来确定连接尝试是否成功。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
  [in]  HGRAPH        hGraph,
  [in]  PCWSTR        pwzPeerId,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

parameters

[in] hGraph

对等图的句柄。

[in] pwzPeerId

要在 pAddress 处连接到的对等方的唯一 ID。 指定 NULL 以连接到同一对等图中侦听指定地址的任何对等。

[in] pAddress

指向标识要连接到 的节点的PEER_ADDRESS 结构的指针。

[out] pullConnectionId

接收指向包含连接 ID 的 ULONGLONG 的指针。 此 ID 可与直接通信函数一起使用。

返回值

如果函数调用成功，则返回值 S_OK。 否则，它将返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 内存不足，无法执行指定的操作。
PEER_E_ALREADY_EXISTS
 与指定节点的邻居连接已存在。
PEER_E_INVALID_GRAPH
 对等图的句柄无效。
PEER_E_NOT_INITIALIZED
 使用此函数之前，必须通过调用 PeerGraphStartup 来初始化图形。

要求

   
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

请参阅

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData