Freigeben über

PEER_EVENT_CONNECTION_CHANGE_DATA Struktur (p2p.h)

Eine PEER_GRAPH_EVENT_DATA Struktur verweist auf die PEER_EVENT_CONNECTION_CHANGE_DATA Struktur, wenn eines der folgenden Peerereignisse ausgelöst wird:

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
Die PEER_EVENT_CONNECTION_CHANGE_DATA-Struktur enthält aktualisierte Informationen, die Änderungen an einem Nachbarn oder einer direkten Verbindung enthalten.

Syntax

typedef struct peer_event_connection_change_data_tag {
  DWORD                  dwSize;
  PEER_CONNECTION_STATUS status;
  ULONGLONG              ullConnectionId;
  ULONGLONG              ullNodeId;
  ULONGLONG              ullNextConnectionId;
  HRESULT                hrConnectionFailedReason;
} PEER_EVENT_CONNECTION_CHANGE_DATA, *PPEER_EVENT_CONNECTION_CHANGE_DATA;

Elemente

dwSize

Gibt die Größe einer Struktur an.

status

Gibt den Typ der Änderung in einer benachbarten oder direkten Verbindung an. Gültige Werte sind die folgenden:

Wert Bedeutung
PEER_CONNECTED
 Es wurde eine neue eingehende oder ausgehende Verbindung mit dem lokalen Knoten hergestellt.
PEER_CONNECTION_FAILED
 Fehler beim Versuch, eine Verbindung mit einem lokalen Knoten herzustellen.

Es ist möglich, dass ein einzelner Versuch, eine Verbindung herzustellen, zu mehreren Verbindungsfehlern führt. Dies tritt nach dem anfänglichen Verbindungsfehler auf, wenn die Peerinfrastruktur das Element "ullNextConnectionId " auf die Knoten-ID festlegt und eine neue Verbindung versucht. Wenn der ullNextConnectionId-Member 0 ist, werden keine weiteren Verbindungen versucht.
PEER_DISCONNECTED
 Eine vorhandene Verbindung wurde getrennt.

ullConnectionId

Gibt die eindeutige ID für eine Geänderte Verbindung an.

ullNodeId

Gibt die eindeutige ID für den Knoten an, der geändert wurde.

ullNextConnectionId

Windows Vista oder höher. Enthält die nächste verfügbare Knoten-ID, mit der die Gruppierungs- oder Diagramm-APIs versuchen, eine Verbindung herzustellen, wenn eine Verbindung fehlschlägt. Wenn dieses Element den Wert 0 hat, werden keine weiteren Verbindungen versucht.

hrConnectionFailedReason

Windows Vista oder höher. Gibt den Fehlertyp an, wenn eine Verbindung fehlschlägt. hrConnectionFailedReason kann die folgenden Fehlercodes zurückgeben.

Wert Description
PEER_E_CONNECTION_REFUSED Es wurde eine Verbindung hergestellt und abgelehnt. Der Remoteknoten ist bereits bei maximaler Anzahl von Verbindungen vorhanden, oder es ist bereits eine Verbindung vorhanden.
PEER_E_CONNECTION_FAILED Fehler beim Versuch, eine Verbindung mit einem Remoteknoten herzustellen.
PEER_E_CONNECTION_NOT_AUTHENTICATED Während der Authentifizierungsphase geht eine Verbindung verloren. Dies ist das Ergebnis eines Netzwerkfehlers oder des Remoteknotens, der die Verbindung aufbricht.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Mindestanforderungen für unterstützte Server Nicht unterstützt
Header p2p.h

Siehe auch

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA

  • Last updated on