PeerGroupCreate 函式 (p2p.h)

PeerGroupCreate 函式會建立新的對等群組。

語法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreate(
  [in]  PPEER_GROUP_PROPERTIES pProperties,
  [out] HGROUP                 *phGroup
);

[in] pProperties

指定群組特定詳細數據的 PEER_GROUP_PROPERTIES 結構的指標，例如對等組名稱、邀請存留期和目前存留期。此為必要參數。

必須設定下列成員：

無法設定下列成員：

其餘成員是選擇性的。

[out] phGroup

傳回對等群組的句柄指標。以這個句柄做為參數呼叫的任何函式，都有在該對等群組上執行的對應動作。此為必要參數。

如果作業成功，則傳回S_OK。否則，函式會傳回下列其中一個值。

傳回碼	Description
E_INVALIDARG	其中一個參數無效。
E_OUTOFMEMORY	記憶體不足，無法執行指定的作業。
PEER_E_CLOUD_NAME_AMBIGUOUS	pProperties 中指定的雲端無法唯一探索， (多個雲端符合提供的名稱) 。
PEER_E_INVALID_CLASSIFIER	pProperties 中指定的對等群組分類器無效。
PEER_E_INVALID_PEER_NAME	pProperties 中為群組指定的對等名稱無效。
PEER_E_INVALID_PROPERTIES	pProperties 中提供的一或多個對等群組屬性無效。
PEER_E_NO_CLOUD	pProperties 中指定的雲端無法找到。
PEER_E_NO_KEY_ACCESS	拒絕存取身分識別或群組金鑰。一般而言，這是因為包含使用者或計算機密鑰的資料夾 (ACL) 不正確的存取控制清單所造成。當 ACL 手動重設時，就會發生這種情況。
PEER_E_PASSWORD_DOES_NOT_MEET_POLICY	指定的密碼不符合系統密碼需求。
ERROR_DELETE_PENDING	指定為「群組建立者」的對等身分識別已被刪除或正在刪除。

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

在建立之後，群組建立者必須立即呼叫PeerGroupConnect。如果未執行此動作，則提供邀請的使用者會成功呼叫PeerGroupConnect，但將無法接聽，且最終會收到連線失敗事件。

應用程式會呼叫 PeerIdentityCreate 或任何其他傳回身分識別名稱字串的方法，以取得身分識別。此身分識別可作為群組的擁有者，而且是建立時對等群組的初始成員。

對於使用密碼的應用程式，建議藉由呼叫 CryptoProtectMemory 和 SecureZeroMemory 函式安全地處理密碼。

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