Compartilhar via

estrutura PEER_EVENT_CONNECTION_CHANGE_DATA (p2p.h)

  • Artigo

Uma estrutura PEER_GRAPH_EVENT_DATA aponta para a estrutura PEER_EVENT_CONNECTION_CHANGE_DATA se um dos seguintes eventos de par for disparado:

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
A estrutura PEER_EVENT_CONNECTION_CHANGE_DATA contém informações atualizadas que incluem alterações em uma conexão próxima ou direta.

Sintaxe

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;

Membros

dwSize

Especifica o tamanho de uma estrutura.

status

Especifica o tipo de alteração em uma conexão próxima ou direta. Os valores válidos são os seguintes.

Valor Significado
PEER_CONNECTED
 Uma nova conexão de entrada ou saída com o nó local foi estabelecida.
PEER_CONNECTION_FAILED
 Falha ao tentar se conectar a um nó local.

É possível que uma única tentativa de conexão resulte em várias falhas de conexão. Isso ocorrerá após a falha de conexão inicial, quando a infraestrutura de par definir o membro ullNextConnectionId como a ID do Nó e tentar uma nova conexão. Se o membro ullNextConnectionId for 0, nenhuma conexão adicional será tentada.
PEER_DISCONNECTED
 Uma conexão existente foi desconectada.

ullConnectionId

Especifica a ID exclusiva de uma conexão que foi alterada.

ullNodeId

Especifica a ID exclusiva do nó que foi alterado.

ullNextConnectionId

Windows Vista ou posterior. Contém a próxima ID de nó disponível à qual as APIs de agrupamento ou grafo tentarão se conectar quando uma conexão falhar. Se esse membro tiver um valor de 0, nenhuma outra conexão será tentada.

hrConnectionFailedReason

Windows Vista ou posterior. Especifica o tipo de erro quando uma conexão falha. hrConnectionFailedReason pode retornar os seguintes códigos de erro.

Valor Descrição
PEER_E_CONNECTION_REFUSED Uma conexão foi estabelecida e recusada. O nó remoto já está no número máximo de conexões ou já existe uma conexão.
PEER_E_CONNECTION_FAILED Falha ao tentar se conectar a um nó remoto.
PEER_E_CONNECTION_NOT_AUTHENTICATED Uma conexão é perdida durante a fase de autenticação. Isso é o resultado de uma falha de rede ou do nó remoto quebrando a conexão.

Requisitos

   
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Cabeçalho p2p.h

Confira também

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA