PEER_INVITATION_INFO 结构 (p2p.h)

PEER_INVITATION_INFO结构定义有关加入对等组的邀请的信息。 邀请以 Unicode 字符串表示。 若要获取此结构，请将 PeerGroupCreateInvitation 创建的 XML 邀请字符串传递给 PeerGroupParseInvitation。

语法

typedef struct peer_invitation_info_tag {
  DWORD                            dwSize;
  DWORD                            dwFlags;
  PWSTR                            pwzCloudName;
  DWORD                            dwScope;
  DWORD                            dwCloudFlags;
  PWSTR                            pwzGroupPeerName;
  PWSTR                            pwzIssuerPeerName;
  PWSTR                            pwzSubjectPeerName;
  PWSTR                            pwzGroupFriendlyName;
  PWSTR                            pwzIssuerFriendlyName;
  PWSTR                            pwzSubjectFriendlyName;
  FILETIME                         ftValidityStart;
  FILETIME                         ftValidityEnd;
  ULONG                            cRoles;
  PEER_ROLE_ID                     *pRoles;
  ULONG                            cClassifiers;
  PWSTR                            *ppwzClassifiers;
  CERT_PUBLIC_KEY_INFO             *pSubjectPublicKey;
  PEER_GROUP_AUTHENTICATION_SCHEME authScheme;
} PEER_INVITATION_INFO, *PPEER_INVITATION_INFO;

成员

dwSize

指定此结构的大小（以字节为单位）。

dwFlags

必须设置为 0x00000000。

pwzCloudName

指向指定 PNRP 云名称的 Unicode 字符串的指针。

dwScope

指定注册对等组的范围。

值	含义
PNRP_GLOBAL_SCOPE	全局范围，包括 Internet。
PNRP_LOCAL_SCOPE	本地范围。
PNRP_LINK_LOCAL_SCOPE	链接本地范围。

dwCloudFlags

指定一组描述 PNRP 云功能的标志。

值	含义
PNRP_CLOUD_NO_FLAGS 0	不设置任何标志。
PNRP_CLOUD_NAME_LOCAL 1	云名称在其他计算机上不可用;它是在本地定义的。

pwzGroupPeerName

指向 Unicode 字符串的指针，该字符串指定对等组的对等名称。

pwzIssuerPeerName

指向 Unicode 字符串的指针，该字符串指定发出邀请的对等方的 PNRP 名称。

pwzSubjectPeerName

指向 Unicode 字符串的指针，该字符串指定接收邀请的对等方的 PNRP 名称。

pwzGroupFriendlyName

指向 Unicode 字符串的指针，该字符串指定友好 (显示) 对等组的名称。

pwzIssuerFriendlyName

指向 Unicode 字符串的指针，该字符串指定发出邀请的对等方) 显示友好 (名称。

pwzSubjectFriendlyName

指向 Unicode 字符串的指针，该字符串指定友好 (显示) 接收邀请的对等方的名称。

ftValidityStart

指定一个 UTC FILETIME 值，该值指示邀请何时生效。

ftValidityEnd

指定一个 UTC FILETIME 值，该值指示邀请何时无效。

cRoles

指定 pRoles 中存在的角色 GUID 数。

pRoles

指向 GUID 列表的指针，该列表指定组合的可用角色集。 可用角色如下所示。

值	含义
PEER_GROUP_ROLE_ADMIN	此角色可以发出邀请、续订成员身份、修改对等组属性、发布和更新记录，以及续订其他管理员的 GMC。
PEER_GROUP_ROLE_MEMBER	该角色可以将记录发布到对等组数据库。

cClassifiers

包含 ppwzClassifiers 中列出的字符串值数的无符号整数值。 保留此字段供将来使用。

ppwzClassifiers

指向 Unicode 字符串的指针列表。 保留此字段供将来使用。

pSubjectPublicKey

指向 CERT_PUBLIC_KEY_INFO 结构的指针，该结构包含收件人返回的公钥及其使用的加密算法类型。

authScheme

Windows Vista 或更高版本。 PEER_GROUP_AUTHENTICATION_SCHEME枚举值，该值指示用于验证对等组被邀请方的身份验证类型。

要求

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

另请参阅

PeerGroupParseInvitation