共用方式為

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 。 否則，函式會傳回下列其中一個值。

傳回碼 描述
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
PEER_E_CLOUD_NAME_AMBIGUOUS
 pwzCloud中指定的雲端無法唯一探索，例如，多個雲端符合提供的名稱。
PEER_E_NO_CLOUD
 pwzCloud中指定的雲端無法找到。
PEER_E_NO_KEY_ACCESS
 拒絕對等身分識別或對等群組金鑰的存取。 一般而言，這是因為包含使用者或電腦金鑰的資料夾 (ACL) 不正確的存取控制清單所造成。 當 ACL 手動重設時，就會發生這種情況。
 

密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。

備註

多個應用程式可以同時開啟相同的群組。 任何應用程式都可以選擇開啟群組，而不需要後續呼叫 PeerGroupConnect。 這些應用程式會被視為離線。 不過，第二個應用程式可以開啟並聯機至群組，這表示應用程式必須隨時準備好連線。

需求

   
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網路套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2P.lib
Dll P2P.dll

另請參閱

PeerGroupClose

PeerGroupConnect

PeerGroupCreate

PeerGroupJoin