PeerGroupOpen 函式 (p2p.h)
PeerGroupOpen函式會開啟對等已建立或加入的對等群組。 開啟對等群組之後，對等可以註冊事件通知。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
[in] PCWSTR pwzIdentity,
[in] PCWSTR pwzGroupPeerName,
[in] PCWSTR pwzCloud,
[out] HGROUP *phGroup
);
參數
[in] pwzIdentity
Unicode 字串的指標，其中包含對等用來開啟群組的身分識別。 此為必要參數。
[in] pwzGroupPeerName
Unicode 字串的指標，其中包含對等群組的對等名稱。 此為必要參數。
[in] pwzCloud
Unicode 字串的指標，其中包含對等群組所在的 PNRP 雲端名稱。 如果值為 Null，則會使用對等群組屬性中指定的雲端。
[out] phGroup
對等群組控制碼的指標。 如果此值為 Null，則開啟作業不成功。 此為必要參數。
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | 描述 |
|---|---|
|
其中一個參數無效。 |
|
記憶體不足，無法完成作業。 |
|
pwzCloud中指定的雲端無法唯一探索，例如，多個雲端符合提供的名稱。 |
|
pwzCloud中指定的雲端無法找到。 |
|
拒絕對等身分識別或對等群組金鑰的存取。 一般而言，這是因為包含使用者或電腦金鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
備註
多個應用程式可以同時開啟相同的群組。 任何應用程式都可以選擇開啟群組，而不需要後續呼叫 PeerGroupConnect。 這些應用程式會被視為離線。 不過，第二個應用程式可以開啟並聯機至群組，這表示應用程式必須隨時準備好連線。
需求
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網路套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |