PEER_EVENT_APPLICATION_CHANGED_DATA 结构 (p2p.h)

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事件。

当前用户范围优先于所有用户范围。如果应用程序在两个范围内注册，则仅当 当前用户 范围发生更改时，才会触发事件。