peerGroupAddRecord 函数 (p2p.h)

PeerGroupAddRecord 函数将新记录添加到对等组，该记录将传播到所有参与的对等方。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupAddRecord(
  [in]  HGROUP       hGroup,
  [in]  PPEER_RECORD pRecord,
  [out] GUID         *pRecordId
);

[in] hGroup

对等组的句柄。此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。此参数是必需的。

[in] pRecord

指向添加到 hGroup 中指定的对等组的PEER_RECORD结构的指针。此参数是必需的。

必须填充 PEER_RECORD 中的以下成员。

ftExpiration 必须表示为对等时间 (请参阅 PeerGroupUniversalTimeToPeerTime) 。

如果已填充，将忽略并覆盖以下成员。

其余字段是可选的。

[out] pRecordId

指向标识记录的 GUID 的指针。此参数是必需的。

如果函数成功，则返回S_OK。否则，该函数返回以下值之一。

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	内存不足，无法执行指定的操作。
PEER_E_GROUP_NOT_READY	对等组未处于可以添加记录的状态。例如，调用 PeerGroupJoin ，但尚未完成与对等组数据库的同步。
PEER_E_INVALID_ATTRIBUTES	包含 PEER_RECORD 结构的 pwzAttributes 成员中的记录属性的 XML 字符串不符合架构规范。
PEER_E_INVALID_GROUP	对等组的句柄无效。
PEER_E_INVALID_PEER_NAME	提供的对等名称无效。
PEER_E_INVALID_RECORD	PEER_RECORD中的一个或多个字段无效。
PEER_E_MAX_RECORD_SIZE_EXCEEDED	记录已超出对等组属性允许的最大大小。
PEER_E_NOT_AUTHORIZED	该标识无权发布该类型的记录。

可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。

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