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。否则，函数将返回以下值之一。

返回代码	说明
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 函数安全地处理密码。

要求	值
最低受支持的客户端	具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器	无受支持的版本
目标平台	Windows
标头	p2p.h
Library	P2P.lib
DLL	P2P.dll