PeerGroupConnectByAddress 函数 (p2p.h)
PeerGroupConnectByAddress 函数尝试连接到具有已知 IPv6 地址的其他对等方正在参与的对等组。 成功调用此函数后,对等方可以与对等组的其他成员通信。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
[in] HGROUP hGroup,
[in] ULONG cAddresses,
[in] PPEER_ADDRESS pAddresses
);
parameters
[in] hGroup
对等方要连接到的对等组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen、PeerGroupJoin 或 PeerGroupPasswordJoin 函数返回。 此参数是必需的。
[in] cAddresses
pAddresses 指向的PEER_ADDRESS结构的总数。
[in] pAddresses
指向 PEER_ADDRESS 结构列表的指针,这些结构指定参与组的对等方的终结点。
返回值
如果操作成功,则返回S_OK。 否则,函数将返回以下值。
返回代码 | 说明 |
---|---|
|
对等组的句柄无效。 |
可能会从 Microsoft RSA 基本提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀,并在 Winerror.h 中定义。
注解
如果应用程序中未提供 PeerGroupConnectByAddress 的超时值,则遇到故障将导致应用程序挂起。 建议使用 30 秒的超时值。
要求
最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2P.lib |
DLL | P2P.dll |