PEER_EVENT_APPLICATION_CHANGED_DATA 結構 (p2p.h)

發行項
08/25/2023

PEER_EVENT_APPLICATION_CHANGED_DATA結構包含在參與對等共同作業網路的對等互連上引發PEER_EVENT_ENDPOINT_APPLICATION_CHANGED或PEER_EVENT_MY_APPLICATION_CHANGED事件時所傳回的資訊。

語法

typedef struct peer_event_application_changed_data_tag {
  PPEER_CONTACT     pContact;
  PPEER_ENDPOINT    pEndpoint;
  PEER_CHANGE_TYPE  changeType;
  PPEER_APPLICATION pApplication;
} PEER_EVENT_APPLICATION_CHANGED_DATA, *PPEER_EVENT_APPLICATION_CHANGED_DATA;

成員

pContact

PEER_CONTACT結構的指標，其中包含應用程式變更引發事件的連絡人對等連絡人連絡人資訊。

pEndpoint

PEER_ENDPOINT結構的指標，其中包含應用程式資訊變更引發事件的連絡人對等端點資訊。

changeType

PEER_CHANGE_TYPE 列舉值，指定發生的應用程式變更類型。

pApplication

包含已變更應用程式資訊之PEER_APPLICATION 結構的指標。

備註

「應用程式」是一組可在對等端點上使用的軟體或軟體功能。通常，這是指支援對等網路活動的軟體套件，例如遊戲或其他共同作業應用程式。

對等的應用程式具有 GUID，代表單一特定應用程式。註冊對等的應用程式時，此 GUID 和對應的應用程式可以提供給對等的所有受信任連絡人使用，指出對等可以參與的活動。若要取消註冊對等的應用程式，請使用這個 GUID 呼叫 PeerCollabUnregisterApplication 。

使用 PeerCollabRegisterApplication 在本機註冊新的應用程式時，或使用 PeerCollabUnregisterApplication 取消註冊所有訂閱本機對等目前狀態資訊的對等，都會收到PEER_EVENT_ENDPOINT_APPLICATION_CHANGED事件。在本機，應用程式會收到PEER_EVENT_MY_APPLICATION_CHANGED事件。

目前的使用者範圍優先于所有使用者範圍。如果在這兩個範圍中註冊應用程式，只有在 目前的使用者 範圍變更時，才會引發事件。