PeerGroupJoin 函式 (p2p.h)
PeerGroupJoin函式會在呼叫PeerGroupConnect 或 PeerGroupConnectByAddress之前，先準備邀請加入現有的對等群組。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzInvitation,
[in] PCWSTR pwzCloud,
[out] HGROUP *phGroup
);
參數
[in] pwzIdentity
Unicode 字串的指標，其中包含開啟指定對等群組的身分識別。 如果此參數為 Null，實作會使用從 PeerIdentityGetDefault 取得的身分識別。
[in] pwzInvitation
Unicode 字串的指標，其中包含另一個對等所授與的 XML 邀請。 邀請者呼叫 PeerGroupCreateInvitation 或 PeerGroupIssueCredentials時，就會建立邀請。 呼叫PeerGroupParseInvitation，即可取得有關此邀請的特定詳細資料作為PEER_INVITATION_INFO結構。 此為必要參數。
[in] pwzCloud
Unicode 字串的指標，其中包含群組所在的 PNRP 雲端名稱。 預設值為 Null，表示必須使用邀請中指定的雲端。
[out] phGroup
對等群組控制碼的指標。 若要開始與群組通訊，請呼叫 PeerGroupConnect。 此為必要參數。
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法完成作業。 |
|
雲端無法唯一探索，例如，多個雲端符合所提供的名稱。 |
|
pwzIdentity中指定的對等識別無效。 |
|
邀請中指定的有效期間無效。 指定的期間已過期，或邀請尚未有效 (亦即尚未達到指定的 ValidityStart 日期\時間) 。 傳回此錯誤的其中一個可能原因是，系統時鐘在加入群組的電腦上或發出邀請的電腦上設定不正確。 |
|
邀請不受信任。 這可能是因為邀請變更、錯誤或到期。 |
|
無法找到雲端。 |
|
目前版本的對等基礎結構不支援邀請。 |
|
拒絕對等身分識別或對等群組金鑰的存取。 一般而言，這是由包含使用者或電腦金鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 已手動重設時，就會發生這種情況。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* ，並在 Winerror.h 中定義。
需求
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 搭配 SP1 與適用于Windows XP 的進階網路套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |