PEER_GROUP_EVENT_DATA-Struktur (p2p.h)

Artikel
08/25/2023

Die PEER_GROUP_EVENT_DATA-Struktur enthält Informationen zu einem bestimmten Peergruppenereignis, das aufgetreten ist.

Syntax

typedef struct peer_group_event_data_tag {
  PEER_GROUP_EVENT_TYPE eventType;
  union {
    PEER_GROUP_STATUS                 dwStatus;
    PEER_EVENT_INCOMING_DATA          incomingData;
    PEER_EVENT_RECORD_CHANGE_DATA     recordChangeData;
    PEER_EVENT_CONNECTION_CHANGE_DATA connectionChangeData;
    PEER_EVENT_MEMBER_CHANGE_DATA     memberChangeData;
    HRESULT                           hrConnectionFailedReason;
  };
} PEER_GROUP_EVENT_DATA, *PPEER_GROUP_EVENT_DATA;

Member

eventType

PEER_GROUP_EVENT_TYPE Enumerationswert, der den Typ des aufgetretenen Peergruppenereignisses angibt. Die Art des Ereignisses diktiert die nachfolgende Struktur, die aus der Union ausgewählt wurde; Wenn dieser Wert beispielsweise auf PEER_GROUP_EVENT_INCOMING_DATA festgelegt ist, lautet das aufgefüllte Union-Element incomingData.

dwStatus

Gibt die PEER_GROUP_STATUS Flagwerte an, die die neue status der Peergruppe angeben. Dieses Feld wird aufgefüllt, wenn ein PEER_GROUP_EVENT_STATUS_CHANGED-Ereignis ausgelöst wird.

incomingData

Gibt die PEER_EVENT_INCOMING_DATA-Struktur an, die Informationen zu eingehenden Daten von einem Peer enthält. Diese Struktur wird aufgefüllt, wenn ein PEER_GROUP_EVENT_INCOMING_DATA-Ereignis ausgelöst wird.

recordChangeData

Gibt die PEER_EVENT_RECORD_CHANGE_DATA-Struktur an, die Daten enthält, die eine Datensatzänderung beschreiben. Diese Struktur wird aufgefüllt, wenn ein PEER_GROUP_EVENT_RECORD_CHANGED-Ereignis ausgelöst wird.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA Struktur, die Informationen enthält, wenn sich eine direkte oder benachbarte Verbindung geändert hat. Diese Struktur wird aufgefüllt, wenn ein PEER_GROUP_EVENT_DIRECT_CONNECTION- oder PEER_GROUP_EVENT_NEIGHBOR_CONNECTION-Ereignis ausgelöst wird.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA Struktur, die Daten enthält, wenn sich die status eines Peergruppenmitglieds ändert. Diese Struktur wird aufgefüllt, wenn ein PEER_GROUP_EVENT_MEMBER_CHANGED-Ereignis ausgelöst wird.

hrConnectionFailedReason

HRESULT , das den Typ des aufgetretenen Verbindungsfehlers angibt. Dieser Wert wird aufgefüllt, wenn ein PEER_GROUP_EVENT_CONNECTION_FAILED-Ereignis ausgelöst wird. Dieser Wert ist einer der folgenden:

Wert	Bedeutung
PEER_E_NO_MEMBERS_FOUND	Es wurden keine verfügbaren Peers innerhalb der Peergruppe gefunden, mit der eine Verbindung hergestellt werden kann.
PEER_E_NO_MEMBER_CONNECTIONS	Es waren keine Memberverbindungen verfügbar.
PEER_E_UNABLE_TO_LISTEN	Der Peer konnte aus einem nicht angegebenen Grund keine Verbindungsdaten empfangen.
PEER_E_NOT_AUTHORIZED	Es wurde versucht, einen nicht autorisierten Vorgang auszuführen. Beispiel: Versuch, einer Gruppe mit einem ungültigen Kennwort beizutreten.