peerGroupConnect 函数 (p2p.h)
PeerGroupConnect 函数启动对等组的 PNRP 搜索，并尝试连接到该组。 成功调用此函数后，对等方可以与对等组的其他成员通信。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
参数
[in] hGroup
对等方要连接到的对等组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen、PeerGroupJoin 或 PeerGroupPasswordJoin 函数返回。 此参数是必需的。
返回值
如果操作成功，则返回S_OK。 否则，函数将返回以下值。
| 返回代码 | 说明 |
|---|---|
|
对等组的句柄无效。 |
可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。
注解
应用程序在调用此函数之前注册对等事件。 如果函数调用不成功，将引发PEER_GROUP_EVENT_CONNECTION_FAILED事件。 否则，将引发PEER_GROUP_EVENT_STATUS_CHANGED 事件。
当组创建者在创建后无法立即调用 PeerGroupConnect 时，也会引发PEER_GROUP_EVENT_CONNECTION_FAILED事件。 如果未执行此操作，则给定邀请的用户将成功调用 PeerGroupConnect ，但他们将无法侦听并最终收到连接失败事件。
如果参与的计算机之间出现时钟偏差， PeerGroupConnect 的成功可能取决于倾斜的严重性。 排查联接失败时，应通过验证计算机时钟是否已同步来考虑这种可能性。
若要存在于对等组中并接收事件，但保持未连接状态，请使用 PeerGroupOpen 函数。
如果在应用程序中未提供 PeerGroupConnect 的超时值，则遇到故障将导致应用程序挂起。 建议超时值 30 秒。
在调用 PeerGroupConnect 之前，组处于“已断开连接状态”。 在此期间，无法检测到组或接收连接。 若要将组返回到此状态，必须调用 PeerGroupClose 函数。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |