estructura PEER_GROUP_EVENT_DATA (p2p.h)

Artículo
03/01/2024

La estructura PEER_GROUP_EVENT_DATA contiene información sobre un evento de grupo del mismo nivel específico que se ha producido.

Sintaxis

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;

Miembros

eventType

PEER_GROUP_EVENT_TYPE valor de enumeración que especifica el tipo de evento de grupo del mismo nivel que se produjo. El tipo de evento dicta la estructura subsiguiente elegida de la unión; por ejemplo, si este valor se establece en PEER_GROUP_EVENT_INCOMING_DATA, el miembro de unión rellenado es incomingData.

dwStatus

Especifica los valores de marca PEER_GROUP_STATUS que indican el nuevo estado del grupo del mismo nivel. Este campo se rellena si se genera un evento de PEER_GROUP_EVENT_STATUS_CHANGED.

incomingData

Especifica la estructura PEER_EVENT_INCOMING_DATA que contiene información sobre los datos entrantes de un mismo nivel. Esta estructura se rellena si se genera un evento de PEER_GROUP_EVENT_INCOMING_DATA.

recordChangeData

Especifica la estructura PEER_EVENT_RECORD_CHANGE_DATA que contiene datos que describen un cambio de registro. Esta estructura se rellena si se genera un evento de PEER_GROUP_EVENT_RECORD_CHANGED.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA estructura que contiene información cuando ha cambiado una conexión directa o vecina. Esta estructura se rellena si se genera un evento PEER_GROUP_EVENT_DIRECT_CONNECTION o PEER_GROUP_EVENT_NEIGHBOR_CONNECTION.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA estructura que contiene datos cuando cambia el estado de un miembro del grupo del mismo nivel. Esta estructura se rellena si se genera un evento de PEER_GROUP_EVENT_MEMBER_CHANGED.

hrConnectionFailedReason

HRESULT que indica el tipo de error de conexión que se produjo. Este valor se rellena si se genera un evento de PEER_GROUP_EVENT_CONNECTION_FAILED. Este valor es uno de los siguientes:

Valor	Significado
PEER_E_NO_MEMBERS_FOUND	No se encontró ningún elemento del mismo nivel disponible en el grupo del mismo nivel al que conectarse.
PEER_E_NO_MEMBER_CONNECTIONS	No había conexiones de miembro disponibles.
PEER_E_UNABLE_TO_LISTEN	El elemento del mismo nivel no pudo recibir datos de conexión por un motivo no especificado.
PEER_E_NOT_AUTHORIZED	Se ha intentado realizar una operación no autorizada. Por ejemplo, intentando unir un grupo con una contraseña no válida.