PEER_GROUP_EVENT_DATA structure (p2p.h)

Article
03/01/2024

La structure PEER_GROUP_EVENT_DATA contient des informations sur un événement de groupe d’homologues spécifique qui s’est produit.

Syntaxe

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;

Membres

eventType

PEER_GROUP_EVENT_TYPE valeur d’énumération qui spécifie le type d’événement de groupe d’homologues qui s’est produit. Le type d’événement dicte la structure suivante choisie à partir de l’union ; par exemple, si cette valeur est définie sur PEER_GROUP_EVENT_INCOMING_DATA, le membre de l’union renseigné est incomingData.

dwStatus

Spécifie les valeurs d’indicateur PEER_GROUP_STATUS qui indiquent la nouvelle status du groupe d’homologues. Ce champ est rempli si un événement PEER_GROUP_EVENT_STATUS_CHANGED est déclenché.

incomingData

Spécifie la structure PEER_EVENT_INCOMING_DATA qui contient des informations sur les données entrantes provenant d’un homologue. Cette structure est remplie si un événement PEER_GROUP_EVENT_INCOMING_DATA est déclenché.

recordChangeData

Spécifie la structure PEER_EVENT_RECORD_CHANGE_DATA qui contient des données qui décrivent une modification d’enregistrement. Cette structure est remplie si un événement PEER_GROUP_EVENT_RECORD_CHANGED est déclenché.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA structure qui contient des informations lorsqu’une connexion directe ou voisine a changé. Cette structure est remplie si un événement PEER_GROUP_EVENT_DIRECT_CONNECTION ou PEER_GROUP_EVENT_NEIGHBOR_CONNECTION est déclenché.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA structure qui contient des données lorsque le status d’un membre de groupe homologue change. Cette structure est remplie si un événement PEER_GROUP_EVENT_MEMBER_CHANGED est déclenché.

hrConnectionFailedReason

HRESULT qui indique le type d’échec de connexion qui s’est produit. Cette valeur est renseignée si un événement PEER_GROUP_EVENT_CONNECTION_FAILED est déclenché. Cette valeur est l’une des suivantes :

Valeur	Signification
PEER_E_NO_MEMBERS_FOUND	Aucun homologue disponible au sein du groupe d’homologues n’a été trouvé auquel se connecter.
PEER_E_NO_MEMBER_CONNECTIONS	Aucune connexion aux membres n’était disponible.
PEER_E_UNABLE_TO_LISTEN	L’homologue n’a pas pu recevoir les données de connexion pour une raison non spécifiée.
PEER_E_NOT_AUTHORIZED	Une tentative d’exécution d’une opération non autorisée a été effectuée. Par exemple, la tentative de rejoindre un groupe avec un mot de passe non valide.