Compartir a través de

estructura de PEER_EVENT_CONNECTION_CHANGE_DATA (p2p.h)

  • Artículo

Una estructura de PEER_GRAPH_EVENT_DATA apunta a la estructura de PEER_EVENT_CONNECTION_CHANGE_DATA si se desencadena uno de los siguientes eventos del mismo nivel:

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
La estructura de PEER_EVENT_CONNECTION_CHANGE_DATA contiene información actualizada que incluye cambios en un vecino o conexión directa.

Sintaxis

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

Especifica el tamaño de una estructura.

status

Especifica el tipo de cambio en un vecino o conexión directa. Los valores válidos son los siguientes.

Valor Significado
PEER_CONNECTED
 Se ha establecido una nueva conexión entrante o saliente al nodo local.
PEER_CONNECTION_FAILED
 Error al intentar conectarse a un nodo local.

Es posible que un único intento de conexión produzca varios errores de conexión. Esto se producirá después del error de conexión inicial, cuando la infraestructura del mismo nivel establece el miembro ullNextConnectionId en el identificador de nodo e intenta una nueva conexión. Si el miembro ullNextConnectionId es 0, no se intentarán más conexiones.
PEER_DISCONNECTED
 Se ha desconectado una conexión existente.

ullConnectionId

Especifica el identificador único de una conexión que ha cambiado.

ullNodeId

Especifica el identificador único del nodo que ha cambiado.

ullNextConnectionId

Windows Vista o posterior. Contiene el siguiente identificador de nodo disponible al que las API de agrupación o grafos intentarán conectarse cuando se produzca un error en una conexión. Si este miembro tiene un valor de 0, no se intentarán más conexiones.

hrConnectionFailedReason

Windows Vista o posterior. Especifica el tipo de error cuando se produce un error en una conexión. hrConnectionFailedReason puede devolver los siguientes códigos de error.

Valor Descripción
PEER_E_CONNECTION_REFUSED Se ha establecido y rechazado una conexión. El nodo remoto ya está en el número máximo de conexiones o ya existe una conexión.
PEER_E_CONNECTION_FAILED Error al intentar conectarse a un nodo remoto.
PEER_E_CONNECTION_NOT_AUTHENTICATED Se pierde una conexión durante la fase de autenticación. Este es el resultado de un error de red o del nodo remoto que rompe la conexión.

Requisitos

   
Cliente mínimo compatible Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible No se admite ninguno
Encabezado p2p.h

Consulte también

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA