通过

PeerGroupCreatePasswordInvitation 函数 (p2p.h)

  • 项目

PeerGroupCreatePasswordInvitation 函数返回一个 XML 字符串，指定的对等方可以使用该字符串来联接具有匹配密码的组。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupCreatePasswordInvitation(
  [in]  HGROUP hGroup,
  [out] PWSTR  *ppwzInvitation
);

参数

[in] hGroup

发出此邀请的对等组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。

[out] ppwzInvitation

指向包含颁发者邀请的 Unicode 字符串的指针。 此邀请可由收件人传递到 PeerGroupPasswordJoin ，以便加入指定的对等组。 若要以 PEER_INVITATION_INFO 结构的形式返回邀请的详细信息，请将此字符串传递给 PeerGroupParseInvitation。 若要释放此数据，请将此指针传递给 PeerFreeData。

此函数要求在传递给 PeerGroupCreate的 PEER_GROUP_PROPERTIES 结构上设置以下字段。

  • pwzGroupPassword。 此字段必须包含用于验证加入对等组的对等方的密码。
  • groupPasswordRole。 此字段必须包含需要密码的角色 (管理员或对等) 的 GUID。
  • dwAuthenticationSchemes。 此字段上必须设置 PEER_GROUP_PASSWORD_AUTHENTICATION 标志 (0x00000001) 。

返回值

如果操作成功，则返回S_OK;否则，函数将返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
E_OUTOFMEMORY
 内存不足，无法执行指定的操作。
PEER_E_GROUP_NOT_READY
 对等组未处于可以添加记录的状态。 例如，调用 PeerGroupJoin ，但尚未完成与组数据库的同步。
PEER_E_CHAIN_TOO_LONG
 GMC 链超过 24 个管理员或成员。 有关 GMC 链的详细信息，请参阅 组安全性工作原理 文档。
PEER_E_IDENTITY_DELETED
 作为 pwzIdentityInfo 传递的数据用于已删除的标识，不再有效。
PEER_E_NOT_AUTHORIZED
 调用此方法的对等方不是管理员。
PEER_E_NO_KEY_ACCESS
 拒绝访问标识或对等组密钥。 通常，这是由于包含用户或计算机密钥的文件夹的访问控制列表 (ACL) 不正确导致的。 手动重置 ACL 时可能会发生这种情况。
 

特定于加密的错误可能会从 Microsoft RSA 基础提供程序返回。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

要求

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