Freigeben über

PEER_EVENT_CONNECTION_CHANGE_DATA Struktur (p2p.h)

  • Artikel

Eine PEER_GRAPH_EVENT_DATA-Struktur zeigt 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 einer benachbarten oder 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;

Members

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
 Eine neue ein- oder ausgehende Verbindung mit dem lokalen Knoten wurde hergestellt.
PEER_CONNECTION_FAILED
 Fehler beim Herstellen einer Verbindung mit einem lokalen Knoten.

Es ist möglich, dass ein einzelner Verbindungsversuch zu mehreren Verbindungsfehlern führt. Dies tritt nach dem anfänglichen Verbindungsfehler auf, wenn die Peerinfrastruktur den ullNextConnectionId-Member auf die Knoten-ID festlegt und eine neue Verbindung versucht. Wenn das Element ullNextConnectionId 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 Graphing-APIs versuchen, eine Verbindung herzustellen, wenn eine Verbindung fehlschlägt. Wenn dieses Element den Wert 0 aufweist, werden keine weiteren Verbindungen versucht.

hrConnectionFailedReason

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

Wert BESCHREIBUNG
PEER_E_CONNECTION_REFUSED Eine Verbindung wurde hergestellt und abgelehnt. Der Remoteknoten hat bereits die maximale Anzahl von Verbindungen, oder es besteht bereits eine Verbindung.
PEER_E_CONNECTION_FAILED Der Versuch, eine Verbindung mit einem Remoteknoten herzustellen, ist fehlgeschlagen.
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 unterbricht.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server) Nicht unterstützt
Kopfzeile p2p.h

Weitere Informationen

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA