PeerGroupConnectByAddress 函数 (p2p.h)

PeerGroupConnectByAddress 函数尝试连接到具有已知 IPv6 地址的其他对等方正在参与的对等组。 成功调用此函数后,对等方可以与对等组的其他成员通信。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
  [in] HGROUP        hGroup,
  [in] ULONG         cAddresses,
  [in] PPEER_ADDRESS pAddresses
);

parameters

[in] hGroup

对等方要连接到的对等组的句柄。 此句柄由 PeerGroupCreatePeerGroupOpenPeerGroupJoinPeerGroupPasswordJoin 函数返回。 此参数是必需的。

[in] cAddresses

pAddresses 指向的PEER_ADDRESS结构的总数。

[in] pAddresses

指向 PEER_ADDRESS 结构列表的指针,这些结构指定参与组的对等方的终结点。

返回值

如果操作成功,则返回S_OK。 否则,函数将返回以下值。

返回代码 说明
PEER_E_INVALID_GROUP
对等组的句柄无效。
 

可能会从 Microsoft RSA 基本提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀,并在 Winerror.h 中定义。

注解

如果应用程序中未提供 PeerGroupConnectByAddress 的超时值,则遇到故障将导致应用程序挂起。 建议使用 30 秒的超时值。

要求

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

请参阅

PEER_ADDRESS

PeerGroupConnect

PeerGroupJoin

PeerGroupPasswordJoin