Share via

PeerGraphOpenDirectConnection 函数 (p2p.h)

  • 项目

PeerGraphOpenDirectConnection 函数允许应用程序与对等图中的节点建立直接连接。 仅当应用程序连接到的节点已订阅 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件时，才能建立 连接 。 然后，应用程序可以直接将数据发送到另一个节点。 对此函数的调用是异步的。

语法

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

参数

[in] hGraph

对等图的句柄。

[in] pwzPeerId

指向要连接到的用户或节点的唯一 ID 的指针。 此参数用于标识特定用户，因为多个标识可以附加到指定的地址。

[in] pAddress

指向包含要连接到的节点地址 的PEER_ADDRESS 结构的指针。

[out] pullConnectionId

接收所请求的连接的连接 ID。

返回值

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

返回代码 说明
PEER_E_INVALID_GRAPH
 图形的句柄无效。
PEER_E_NOT_INITIALIZED
 在使用此函数之前，必须通过调用 PeerGraphStartup 初始化图形。

注解

调用 PeerGraphOpenDirectConnection 是异步调用。 触发 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件以通知应用程序直接连接成功或失败。 函数成功或失败的实际状态在 PEER_GRAPH_EVENT_DATA 结构中给出。

要求

要求 值
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

另请参阅

PEER_ADDRESS

PeerGraphCloseDirectConnection

PeerGraphEnumConnections