Partager via

PEER_EVENT_CONNECTION_CHANGE_DATA structure (p2p.h)

  • Article

Une structure PEER_GRAPH_EVENT_DATA pointe vers la structure PEER_EVENT_CONNECTION_CHANGE_DATA si l’un des événements homologues suivants est déclenché :

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
La structure PEER_EVENT_CONNECTION_CHANGE_DATA contient des informations mises à jour qui incluent les modifications apportées à une connexion directe ou voisine.

Syntaxe

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;

Membres

dwSize

Spécifie la taille d’une structure.

status

Spécifie le type de modification dans une connexion directe ou voisine. Les valeurs valides sont les suivantes.

Valeur Signification
PEER_CONNECTED
 Une nouvelle connexion entrante ou sortante au nœud local a été établie.
PEER_CONNECTION_FAILED
 Une tentative de connexion à un nœud local a échoué.

Il est possible qu’une seule tentative de connexion entraîne plusieurs échecs de connexion. Cela se produit après l’échec initial de la connexion, lorsque l’infrastructure homologue définit le membre ullNextConnectionId sur l’ID de nœud et tente une nouvelle connexion. Si le membre ullNextConnectionId est 0, aucune autre connexion n’est tentée.
PEER_DISCONNECTED
 Une connexion existante a été déconnectée.

ullConnectionId

Spécifie l’ID unique d’une connexion qui a changé.

ullNodeId

Spécifie l’ID unique du nœud qui a changé.

ullNextConnectionId

Windows Vista ou version ultérieure. Contient l’ID de nœud disponible suivant auquel les API de regroupement ou de graphique tentent de se connecter en cas d’échec d’une connexion. Si ce membre a la valeur 0, aucune autre connexion n’est tentée.

hrConnectionFailedReason

Windows Vista ou version ultérieure. Spécifie le type d’erreur en cas d’échec d’une connexion. hrConnectionFailedReason peut retourner les codes d’erreur suivants.

Valeur Description
PEER_E_CONNECTION_REFUSED Une connexion a été établie et refusée. Le nœud distant est déjà au nombre maximal de connexions ou une connexion existe déjà.
PEER_E_CONNECTION_FAILED Une tentative de connexion à un nœud distant a échoué.
PEER_E_CONNECTION_NOT_AUTHENTICATED Une connexion est perdue pendant la phase d’authentification. Cela est le résultat d’une défaillance du réseau ou du nœud distant qui interrompt la connexion.

Spécifications

   
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge Aucun pris en charge
En-tête p2p.h

Voir aussi

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA