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 |