PeerGroupOpen 函数 (p2p.h)

  • 项目

PeerGroupOpen 函数打开对等方已创建或加入的对等组。 打开对等组后，对等方可以注册事件通知。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

parameters

[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。 这些应用程序被视为脱机。 但是，第二个应用程序可以打开并将对等连接到组，这意味着应用程序必须随时准备好连接。

要求

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

请参阅

PeerGroupClose

PeerGroupConnect

PeerGroupCreate

PeerGroupJoin