peerGraphAddRecord 函数 (p2p.h)

PeerGraphAddRecord 函数向对等图添加新记录。 使用此函数添加的记录将发送到对等图中的每个节点。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphAddRecord(
  [in]  HGRAPH       hGraph,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

参数

[in] hGraph

对等图的句柄。

[in] pRecord

指向要添加的记录的指针。

[out] pRecordId

指定唯一标识对等图中的记录的记录 ID。

返回值

如果函数调用成功，则返回值 S_OK。 否则，它将返回以下值之一。

返回代码	说明
E_ACCESSDENIED	无法访问对等图。
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	内存不足，无法执行指定的操作。
PEER_E_GRAPH_NOT_READY	图未同步。 在同步对等图之前，无法添加记录。
PEER_E_GRAPH_SHUTTING_DOWN	已调用 PeerGraphClose。
PEER_E_INVALID_ATTRIBUTES	指定的属性与架构不匹配。
PEER_E_INVALID_GRAPH	对等图的句柄无效。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	记录超出了对等图允许的最大大小。
PEER_E_NOT_INITIALIZED	在使用此函数之前，必须通过调用 PeerGraphStartup 来初始化图形。

注解

PEER_RECORD 结构的以下成员必须包含有效值：

• dwSize。
• 类型。
• ftExpiration - 必须晚于当前图形时间，并且必须使用 PeerGraphUniversalTimeToPeerTime 在对等时间中指定。

PEER_RECORD 结构的以下成员是可选的。 如果应用程序未使用它们，请将其设置为 NULL ：

• data
• pwzAttributes
• securityData
• dwVersion

如果以下任一成员为 NULL，则对等图形 API 将执行指定的默认行为：

• pwzCreatorId - 使用传递给 PeerGraphCreate 或 PeerGraphOpen 的对等 ID。
• pwzModifiedById - 使用 pwzCreatorId。

无法指定以下成员：对等图形基础结构会覆盖使用的任何值：

• id。
• ftCreation - 使用对等时间。
• ftLastModified - 使用对等时间。

要求

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

另请参阅

PEER_RECORD

PeerGraphDelete

PeerGraphGetEventData

PeerGraphUpdate