PeerGroupConnect 函式 (p2p.h)
PeerGroupConnect 函式會起始對等群組的 PNRP 搜尋，並嘗試與其連線。 成功呼叫此函式之後，對等可以與對等群組的其他成員通訊。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
參數
[in] hGroup
處理對等想要連線的對等群組。 PeerGroupCreate、PeerGroupOpen、PeerGroupJoin 或PeerGroupPasswordJoin 函式會傳回此句柄。 此為必要參數。
傳回值
如果作業成功，則傳回S_OK。 否則，函式會傳回下列值。
| 傳回碼 | Description |
|---|---|
|
對等群組的句柄無效。 |
密碼編譯特定錯誤可以從 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 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |