Condividi tramite

PEER_EVENT_CONNECTION_CHANGE_DATA struttura (p2p.h)

  • Articolo

Una struttura PEER_GRAPH_EVENT_DATA punta alla struttura PEER_EVENT_CONNECTION_CHANGE_DATA se viene attivato uno degli eventi peer seguenti:

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
La struttura PEER_EVENT_CONNECTION_CHANGE_DATA contiene informazioni aggiornate che includono modifiche a una connessione vicina o diretta.

Sintassi

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

Specifica le dimensioni di una struttura.

status

Specifica il tipo di modifica in una connessione vicina o diretta. I valori validi sono i seguenti.

Valore Significato
PEER_CONNECTED
 È stata stabilita una nuova connessione in ingresso o in uscita al nodo locale.
PEER_CONNECTION_FAILED
 Un tentativo di connessione a un nodo locale non è riuscito.

È possibile che un singolo tentativo di connessione possa causare più errori di connessione. Ciò si verifica dopo l'errore di connessione iniziale, quando l'infrastruttura peer imposta il membro ullNextConnectionId sull'ID nodo e tenta una nuova connessione. Se il membro ullNextConnectionId è 0, non verranno tentate altre connessioni.
PEER_DISCONNECTED
 È stata disconnessa una connessione esistente.

ullConnectionId

Specifica l'ID univoco per una connessione modificata.

ullNodeId

Specifica l'ID univoco per il nodo modificato.

ullNextConnectionId

Windows Vista o versione successiva. Contiene l'ID nodo disponibile successivo che le API di raggruppamento o grafico tenteranno di connettersi quando una connessione ha esito negativo. Se questo membro ha un valore pari a 0, non verranno tentate altre connessioni.

hrConnectionFailedReason

Windows Vista o versione successiva. Specifica il tipo di errore quando una connessione ha esito negativo. hrConnectionFailedReason può restituire i codici di errore seguenti.

Valore Descrizione
PEER_E_CONNECTION_REFUSED Una connessione è stata stabilita e rifiutata. Il nodo remoto è già al numero massimo di connessioni o esiste già una connessione.
PEER_E_CONNECTION_FAILED Un tentativo di connessione a un nodo remoto non è riuscito.
PEER_E_CONNECTION_NOT_AUTHENTICATED Una connessione viene persa durante la fase di autenticazione. Si tratta del risultato di un errore di rete o del nodo remoto che interrompe la connessione.

Requisiti

   
Client minimo supportato Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato Nessuno supportato
Intestazione p2p.h

Vedi anche

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA