PeerCollabDeleteObject 函数 (p2p.h)

PeerCollabDeleteObject 函数从调用终结点中删除对等对象。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteObject(
  [in] const GUID *pObjectId
);

[in] pObjectId

指向 GUID 值的指针，该值唯一标识要从调用终结点中删除的对等对象。

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

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

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

监视此对等对象的受信任联系人和“Me”联系人的订阅者将引发PEER_EVENT_OBJECT_CHANGED事件，发出此对等对象的状态更改的信号。 PEER_EVENT_MY_OBJECT_CHANGED将在本地引发。

预定义对象（如 Picture 对象）无法通过调用此 API 删除。