estrutura PEER_GROUP_EVENT_DATA (p2p.h)

Artigo
03/05/2024

A estrutura PEER_GROUP_EVENT_DATA contém informações sobre um evento de grupo de pares específico que ocorreu.

Sintaxe

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;

Membros

eventType

PEER_GROUP_EVENT_TYPE valor de enumeração que especifica o tipo de evento de grupo par que ocorreu. O tipo de evento determina a estrutura subsequente escolhida da união; por exemplo, se esse valor for definido como PEER_GROUP_EVENT_INCOMING_DATA, o membro da união populada será incomingData.

dwStatus

Especifica os valores do sinalizador PEER_GROUP_STATUS que indicam o novo status do grupo de pares. Esse campo será preenchido se um evento PEER_GROUP_EVENT_STATUS_CHANGED for gerado.

incomingData

Especifica a estrutura de PEER_EVENT_INCOMING_DATA que contém informações sobre dados de entrada de um par. Essa estrutura será preenchida se um evento PEER_GROUP_EVENT_INCOMING_DATA for gerado.

recordChangeData

Especifica a estrutura PEER_EVENT_RECORD_CHANGE_DATA que contém dados que descrevem uma alteração de registro. Essa estrutura será preenchida se um evento de PEER_GROUP_EVENT_RECORD_CHANGED for gerado.

connectionChangeData

PEER_EVENT_CONNECTION_CHANGE_DATA estrutura que contém informações quando uma conexão direta ou vizinha é alterada. Essa estrutura será preenchida se um evento PEER_GROUP_EVENT_DIRECT_CONNECTION ou PEER_GROUP_EVENT_NEIGHBOR_CONNECTION for gerado.

memberChangeData

PEER_EVENT_MEMBER_CHANGE_DATA estrutura que contém dados quando o status de um membro de grupo par é alterado. Essa estrutura será preenchida se um evento PEER_GROUP_EVENT_MEMBER_CHANGED for gerado.

hrConnectionFailedReason

HRESULT que indica o tipo de falha de conexão que ocorreu. Esse valor será preenchido se um evento PEER_GROUP_EVENT_CONNECTION_FAILED for gerado. Esse valor é um dos seguintes:

Valor	Significado
PEER_E_NO_MEMBERS_FOUND	Nenhum par disponível no grupo de pares foi encontrado para se conectar.
PEER_E_NO_MEMBER_CONNECTIONS	Nenhuma conexão de membro estava disponível.
PEER_E_UNABLE_TO_LISTEN	O par não pôde receber dados de conexão por um motivo não especificado.
PEER_E_NOT_AUTHORIZED	Foi feita uma tentativa de executar uma operação não autorizada. Por exemplo, tentar ingressar em um grupo com uma senha inválida.