PEER_EVENT_OBJECT_CHANGED_DATA 结构 (p2p.h)

项目
03/13/2024

PEER_EVENT_OBJECT_CHANGED_DATA 结构包含在参与对等协作网络的对等方上引发PEER_EVENT_ENDPOINT_OBJECT_CHANGED或PEER_EVENT_MY_OBJECT_CHANGED事件时返回的信息。

语法

typedef struct peer_event_object_changed_data_tag {
  PPEER_CONTACT    pContact;
  PPEER_ENDPOINT   pEndpoint;
  PEER_CHANGE_TYPE changeType;
  PPEER_OBJECT     pObject;
} PEER_EVENT_OBJECT_CHANGED_DATA, *PPEER_EVENT_OBJECT_CHANGED_DATA;

成员

pContact

指向 PEER_CONTACT 结构的指针，该结构包含其对等对象数据已更改的联系人的对等联系人的对等联系人的联系人信息。

pEndpoint

指向 PEER_ENDPOINT 结构的指针，该结构包含其对等对象数据已更改的联系人的对等终结点信息。

changeType

PEER_CHANGE_TYPE 枚举值，该值指定发生的更改类型。

pObject

指向 PEER_OBJECT 结构的指针，该结构包含其更改引发事件的对等对象数据。当对等方收到新的对等对象时，最常发生此情况。

注解

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

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

通过调用 PeerCollabSetObject 更改对象时，将引发PEER_EVENT_OBJECT_CHANGED事件。如果是首次设置对象，则 changeType 设置为 PEER_CHANGE_ADDED。在对同一对象 ID 的 PeerCollabSetObject 的后续调用中， changeType 设置为 PEER_CHANGE_UDPATED。

如果 PeerCollabDeleteObject 称为 PEER_CHANGE_DELETED 引发事件。