peerCollabSetObject 函数 (p2p.h)

PeerCollabSetObject 函数创建或更新对等协作网络中使用的对等数据对象。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

[in] pcObject

指向包含对等协作网络上的对等对象的 PEER_OBJECT 结构的指针。

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

返回代码	说明
E_OUTOFMEMORY	内存不足，无法支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	Windows 对等基础结构未初始化。需要调用相关的初始化函数。
PEER_E_NOT_SIGNED_IN	该操作要求用户登录。

对等对象是与特定应用程序关联的运行时数据项，例如图片、头像、证书或特定说明。每个对等对象的大小必须小于 16K，并且不能为 0。

如果已发布对象， PeerCollabSetObject 将更新现有对象数据。更新对象的最后一个应用程序将获取对象的所有权。因此，如果终止应用程序，则删除对象。

如果由于注销而不是关闭关联的应用程序而删除了对象的“已发布”状态，则应用程序负责在用户下次登录时发布该对象。

监视此对等对象的受信任联系人将在本地引发 PEER_EVENT_OBJECT_CHANGED 事件，指示此对等对象的状态更改。

PeerCollabSetObject 可用于发布最多 128 个对象。

在任何给定时间，都有一个具有给定 GUID 发布的对象。