PEER_EVENT_APPLICATION_CHANGED_DATA-Struktur (p2p.h)

Artikel
08/25/2023

Die PEER_EVENT_APPLICATION_CHANGED_DATA-Struktur enthält Informationen, die zurückgegeben werden, wenn ein PEER_EVENT_ENDPOINT_APPLICATION_CHANGED- oder PEER_EVENT_MY_APPLICATION_CHANGED-Ereignis auf einem Peer ausgelöst wird, der an einem Peerzusammenarbeitsnetzwerk teilnimmt.

Syntax

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;

Members

pContact

Zeiger auf eine PEER_CONTACT Struktur, die die Peerkontaktinformationen für einen Kontakt enthält, dessen Änderung in der Anwendung das Ereignis ausgelöst hat.

pEndpoint

Zeiger auf eine PEER_ENDPOINT Struktur, die die Peerendpunktinformationen für einen Kontakt enthält, dessen Änderung der Anwendungsinformationen das Ereignis ausgelöst hat.

changeType

PEER_CHANGE_TYPE Enumerationswert, der den Typ der aufgetretenen Anwendungsänderung angibt.

pApplication

Zeiger auf eine PEER_APPLICATION-Struktur , die die geänderten Anwendungsinformationen enthält.

Hinweise

"Anwendung" ist eine Reihe von Software- oder Softwarefeatures, die auf dem Endpunkt des Peers verfügbar sind. In der Regel bezieht sich dies auf Softwarepakete, die Peernetzwerkaktivitäten unterstützen, z. B. Spiele oder andere gemeinsame Anwendungen.

Die Anwendung eines Peers verfügt über eine GUID, die eine einzelne spezifische Anwendung darstellt. Wenn eine Anwendung für einen Peer registriert ist, können diese GUID und die entsprechende Anwendung allen vertrauenswürdigen Kontakten des Peers zur Verfügung gestellt werden, was die Aktivitäten angibt, an denen der Peer teilnehmen kann. Um die Registrierung der Anwendung eines Peers aufzuheben, rufen Sie PeerCollabUnregisterApplication mit dieser GUID auf.

Wenn eine neue Anwendung lokal mit PeerCollabRegisterApplication registriert oder die Registrierung mit PeerCollabUnregisterApplication aufgehoben wird, erhalten alle Peers, die die Anwesenheitsinformationen des lokalen Peers abonniert haben, das PEER_EVENT_ENDPOINT_APPLICATION_CHANGED-Ereignis. Lokal empfangen Anwendungen das PEER_EVENT_MY_APPLICATION_CHANGED-Ereignis.

Der aktuelle Benutzerbereich hat Vorrang vor dem Gesamten Benutzerbereich . Wenn die Anwendung in beiden Bereichen registriert ist, wird das Ereignis nur ausgelöst, wenn der aktuelle Benutzerbereich geändert wird.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Kopfzeile	p2p.h

Weitere Informationen

API-Strukturen für Peerzusammenarbeit

Freigeben über