PEER_GRAPH_PROPERTIES 结构 (p2p.h)
PEER_GRAPH_PROPERTIES 结构包含有关对等图策略、ID、范围和其他信息的数据。
语法
typedef struct peer_graph_properties_tag {
DWORD dwSize;
DWORD dwFlags;
DWORD dwScope;
DWORD dwMaxRecordSize;
PWSTR pwzGraphId;
PWSTR pwzCreatorId;
PWSTR pwzFriendlyName;
PWSTR pwzComment;
ULONG ulPresenceLifetime;
ULONG cPresenceMax;
} PEER_GRAPH_PROPERTIES, *PPEER_GRAPH_PROPERTIES;
成员
dwSize
指定此数据结构的大小（以字节为单位）。 在调用 PeerGraphCreate 之前，dwSize 成员必须设置为 PEER_GRAPH_PROPERTIES 的大小。 此成员是必需的。 没有默认值。
dwFlags
控制关系图中对等方行为的标志。 默认值为 未设置标志。 下表中标识了有效值。
| 值 | 说明 |
|---|---|
| PEER_GRAPH_PROPERTY_DEFER_EXPIRATION | 指定图形记录的过期时间。 当图形未连接且设置此标志时，在图形连接到至少一个其他成员之前，不会过期。 |
dwScope
指定发布对等图 ID 的范围。 默认值为 global。 下表中标识了有效值。
| 值 | 说明 |
|---|---|
| PEER_GRAPH_SCOPE_GLOBAL | 范围包括 Internet。 |
| PEER_GRAPH_SCOPE_LINK_LOCAL | 范围仅限于本地子网。 |
| PEER_GRAPH_SCOPE_SITE_LOCAL | 范围仅限于站点，例如公司 Intranet。 |
dwMaxRecordSize
指定指示可添加到对等图的最大记录的值。 有效值为零 (0) ，指示默认最大记录大小 (60 兆字节) 使用，任何介于 1024 字节和 60 兆字节之间的值。
pwzGraphId
指定对等图的唯一标识符。 此 ID 对于计算机/用户对必须是唯一的。 此成员是必需的，没有默认值。 如果字符串值大于 256 个字符 (包括 null 终止符) ，则返回错误。
pwzCreatorId
指定对等图的创建者的唯一标识符。 此成员是必需的，没有默认值。 如果字符串值大于 256 个字符 (包括 null 终止符) ，则返回错误。
pwzFriendlyName
指定对等图的友好名称。 此成员是可选的，可以为 NULL。 默认值为 NULL。 此字符串的最大长度为 256 个字符，包括 null 终止符。
pwzComment
指定用于描述对等图的注释。 此成员是可选的，可以为 NULL。 默认值为 NULL。 此字符串的最大长度为 512 个字符，包括 null 终止符。
ulPresenceLifetime
指定状态记录过期之前的秒数。 默认值为“300”秒（5 分钟）。 不要将 ulPresenceLifetime 的值设置为小于 300 秒。 如果此成员设置为小于默认值 300 (5 分钟) ，则可能发生未定义的行为。
cPresenceMax
指定对等基础结构一次保留在对等图中的状态记录数。 已发布状态的节点可由使用 PeerGraphEnumNodes 的所有其他节点枚举。 通过指定下表中标识的值之一，指定发布用户的状态记录的方式。
| 值 | 说明 |
|---|---|
| -1 | 系统会自动为所有用户发布状态记录。 |
| 0 | 状态记录不会自动发布。 |
| 1-N | 一次最多发布 N 个状态记录。 发布的状态记录由对等图形基础结构随机选择。 |
注解
应用程序可以使用 PeerGraphSetPresence 强制对等图形基础结构发布状态信息。
调用 PeerGraphSetProperties 时，只能更新PEER_GRAPH_PROPERTIES中的特定字段。 可以更新以下成员：
- pwzFriendlyName
- pwzComment
- ulPresenceLifetime
- cPresenceMax
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 标头 | p2p.h |