Partager via

structure PEER_EVENT_CONNECTION_CHANGE_DATA (p2p.h)

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 des modifications apportées à un voisin ou une connexion directe.

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;

Members

dwSize

Spécifie la taille d’une structure.

status

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

Valeur Meaning
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 de connexion initial, 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 graphe tenteront de se connecter lorsqu’une connexion échoue. 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 Descriptif
PEER_E_CONNECTION_REFUSED Une connexion a été établie et refusée. Le nœud distant est déjà au maximum nombre 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. Il s’agit du résultat d’une défaillance réseau ou du nœud distant cassant la connexion.

Spécifications

Requirement Valeur
Client minimum requis Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec advanced networking Pack forWindows XP
Serveur minimal pris en charge Aucun pris en charge
Header p2p.h

Voir aussi

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA

  • Last updated on