PEER_EVENT_OBJECT_CHANGED_DATA結構 (p2p.h)

發行項
03/01/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。在後續針對相同對象標識符呼叫 PeerCollabSetObject 時， changeType 會設定為 PEER_CHANGE_UDPATED。

如果呼叫 PeerCollabDeleteObject ，就會引發PEER_CHANGE_DELETED事件。