PEER_RECORD 结构 (p2p.h)

项目
03/01/2024

PEER_RECORD 结构包含应用程序使用的记录对象。

语法

typedef struct peer_record_tag {
  DWORD     dwSize;
  GUID      type;
  GUID      id;
  DWORD     dwVersion;
  DWORD     dwFlags;
  PWSTR     pwzCreatorId;
  PWSTR     pwzModifiedById;
  PWSTR     pwzAttributes;
  FILETIME  ftCreation;
  FILETIME  ftExpiration;
  FILETIME  ftLastModified;
  PEER_DATA securityData;
  PEER_DATA data;
} PEER_RECORD, *PPEER_RECORD;

成员

dwSize

指定结构的大小。将值设置为 sizeof (PEER_RECORD) 。

type

指定记录的类型。类型是应用程序必须指定的 GUID 。 GUID 表示唯一的记录类型，例如聊天记录。

id

指定记录的唯一 ID。对等基础结构提供此 ID。在对 PeerGroupAddRecord 的调用中忽略此参数。应用程序无法修改此成员。

dwVersion

指定应用程序调用 PeerGraphAddRecord 或 PeerGraphUpdateRecord 时对等基础结构提供的记录的版本。应用程序无法修改此成员。

dwFlags

指定指示必须应用于记录的特殊处理的标志。下表标识了有效值。

值	说明
PEER_RECORD_FLAG_AUTOREFRESH	指示记录在准备好过期时自动刷新。
PEER_RECORD_FLAG_DELETED	指示记录标记为已删除。

注意应用程序无法设置这些标志。

pwzCreatorId

指向记录创建者的唯一 ID 的指针。对于对 PeerGraphAddRecord 和 PeerGraphUpdateRecord 的调用，此成员设置为 NULL。应用程序无法设置此成员。

pwzModifiedById

指定更改记录的最后一个人的唯一 ID。应用程序无法设置此成员。

pwzAttributes

指向与记录关联的属性名称和值对集的指针。此成员指向 XML 字符串。记录属性指定为 XML 字符串，它们必须与对等基础结构记录属性架构一致。有关 XML 架构的完整说明，请参阅记录属性架构。

对等基础结构保留用户无法设置的多个属性名称。以下列表标识保留的属性名称：

peerlastmodifiedby
peercreatorid
peerlastmodificationtime
peerrecordid
peerrecordtype
peercreationtime
peerlastmodificationtime

ftCreation

指定创建记录的协调世界时 (UTC) 。对等基础结构提供此值，在调用 PeerGroupAddRecord 时，该值设置为零 (0) 。应用程序无法设置此成员。

ftExpiration

记录过期的 UTC 时间。此成员是必需的。它可以更新为大于最初指定的时间值的时间值，但不能小于最初指定的值。

注意如果 dwFlags 设置为 PEER_RECORD_FLAG_AUTOREFRESH，请不要将 ftExpiration 的值设置为小于 4 (4) 分钟。如果此成员设置为小于 4 (4) 分钟，则可能会出现未定义的行为。

ftLastModified

修改记录的 UTC 时间。对等基础结构提供此值。调用 PeerGraphAddRecord、PeerGraphUpdateRecord、PeerGroupAddRecord 和 PeerGroupUpdateRecord 时，将此成员设置为 NULL。应用程序无法设置此成员。

securityData

指定 PEER_DATA 结构中包含的安全数据。图形 API 使用此成员，并为安全提供程序提供一个用于存储安全数据（例如签名）的位置。分组 API 无法修改此成员。

data

指定此记录包含的实际数据。

要求

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