PEER_GROUP_PROPERTIES 结构 (p2p.h)

PEER_GROUP_PROPERTIES结构包含有关对等组的成员身份策略的数据。

语法

typedef struct peer_group_properties_tag {
  DWORD        dwSize;
  DWORD        dwFlags;
  PWSTR        pwzCloud;
  PWSTR        pwzClassifier;
  PWSTR        pwzGroupPeerName;
  PWSTR        pwzCreatorPeerName;
  PWSTR        pwzFriendlyName;
  PWSTR        pwzComment;
  ULONG        ulMemberDataLifetime;
  ULONG        ulPresenceLifetime;
  DWORD        dwAuthenticationSchemes;
  PWSTR        pwzGroupPassword;
  PEER_ROLE_ID groupPasswordRole;
} PEER_GROUP_PROPERTIES, *PPEER_GROUP_PROPERTIES;

成员

dwSize

结构的大小(以字节为单位)。

dwFlags

PEER_GROUP_PROPERTY_FLAGS 描述对等组行为的标志。 默认值为零 (0) ,表示未设置标志。

pwzCloud

指定对等组参与的 PNRP) 云 (对等名称解析协议的名称。 如果此成员为 NULL,则默认值为“global”。

pwzClassifier

指定用于标识 PNRP 云中注册或解析的对等组对等名称的权威的分类器。 此字段的最大大小为 149 个 Unicode 字符。 此成员可以为 NULL

pwzGroupPeerName

指定向 PNRP 服务注册的对等组的名称。 此字段的最大大小为 137 个 Unicode 字符。

pwzCreatorPeerName

指定与对等组创建者关联的对等名称。 此字段的最大大小为 137 个 Unicode 字符。 如果此结构成员为 NULL,则实现将使用从 PeerIdentityGetDefault 获取的标识。

pwzFriendlyName

指定对等组的友好 (显示) 名称。 此字段的最大大小为 255 个字符。

pwzComment

包含用于描述对等组的注释。 此字段的最大大小为 255 个字符。

ulMemberDataLifetime

指定对等组成员数据的生存期(以秒为单位), (PEER_MEMBER) 。 此字段的最小值为 8 小时,最大值为 10 年。 默认值为 2,419,200 秒,即 28 天。

如果此值设置为零 (0) ,则成员数据具有最长允许生存期,即为成员颁发凭据的管理员生存期内剩余的时间。

ulPresenceLifetime

指定发布到对等组的状态信息的生存期(以秒为单位)。 默认值为 300 秒。 不要将 ulPresenceLifetime 的值设置为小于 300 秒。 如果此成员设置为小于 300 秒默认值,则可能发生未定义的行为。

dwAuthenticationSchemes

Windows Vista 或更高版本。 PEER_GROUP_AUTHENTICATION_SCHEME枚举值的逻辑 OR,这些值指示对等组支持的身份验证类型。

pwzGroupPassword

Windows Vista 或更高版本。 指向 Unicode 字符串的指针,该字符串包含用于对尝试加入对等组的对等方进行身份验证的密码。

groupPasswordRole

Windows Vista 或更高版本。 GUID 值,该值指示身份验证需要其密码的对等组角色。

要求

要求
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
标头 p2p.h

另请参阅

PeerGroupCreate

PeerGroupGetProperties

PeerGroupSetProperties