PEER_GROUP_EVENT_DATA struttura (p2p.h)

Articolo
03/16/2023

La struttura PEER_GROUP_EVENT_DATA contiene informazioni su un evento di gruppo peer specifico che si è verificato.

Sintassi

typedef struct peer_group_event_data_tag {
  PEER_GROUP_EVENT_TYPE eventType;
  union {
    PEER_GROUP_STATUS                 dwStatus;
    PEER_EVENT_INCOMING_DATA          incomingData;
    PEER_EVENT_RECORD_CHANGE_DATA     recordChangeData;
    PEER_EVENT_CONNECTION_CHANGE_DATA connectionChangeData;
    PEER_EVENT_MEMBER_CHANGE_DATA     memberChangeData;
    HRESULT                           hrConnectionFailedReason;
  };
} PEER_GROUP_EVENT_DATA, *PPEER_GROUP_EVENT_DATA;

Members

eventType

PEER_GROUP_EVENT_TYPE valore di enumerazione che specifica il tipo di evento del gruppo peer che si è verificato. Il tipo di evento determina la struttura successiva scelta dall'unione; ad esempio, se questo valore è impostato su PEER_GROUP_EVENT_INCOMING_DATA, il membro dell'unione popolato è in ingressoData.

dwStatus

Specifica i valori del flag PEER_GROUP_STATUS che indicano il nuovo stato del gruppo peer. Questo campo viene popolato se viene generato un evento PEER_GROUP_EVENT_STATUS_CHANGED.

incomingData

Specifica la struttura PEER_EVENT_INCOMING_DATA che contiene informazioni sui dati in ingresso da un peer. Questa struttura viene popolata se viene generato un evento PEER_GROUP_EVENT_INCOMING_DATA.

recordChangeData

Specifica la struttura PEER_EVENT_RECORD_CHANGE_DATA che contiene dati che descrivono una modifica del record. Questa struttura viene popolata se viene generato un evento PEER_GROUP_EVENT_RECORD_CHANGED.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA struttura che contiene informazioni quando è stata modificata una connessione diretta o vicina. Questa struttura viene popolata se viene generato un evento PEER_GROUP_EVENT_DIRECT_CONNECTION o PEER_GROUP_EVENT_NEIGHBOR_CONNECTION.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA struttura che contiene dati quando lo stato di un membro del gruppo peer cambia. Questa struttura viene popolata se viene generato un evento PEER_GROUP_EVENT_MEMBER_CHANGED.

hrConnectionFailedReason

HRESULT che indica il tipo di errore di connessione che si è verificato. Questo valore viene popolato se viene generato un evento PEER_GROUP_EVENT_CONNECTION_FAILED. Questo valore è uno dei seguenti:

Valore	Significato
PEER_E_NO_MEMBERS_FOUND	Non sono stati trovati peer disponibili all'interno del gruppo peer a cui connettersi.
PEER_E_NO_MEMBER_CONNECTIONS	Non sono state disponibili connessioni membro.
PEER_E_UNABLE_TO_LISTEN	Il peer non è riuscito a ricevere i dati di connessione per un motivo non specificato.
PEER_E_NOT_AUTHORIZED	È stato effettuato un tentativo di eseguire un'operazione non autorizzata. Ad esempio, tentando di aggiungere un gruppo con una password non valida.