Partilhar via

estrutura PEER_EVENT_CONNECTION_CHANGE_DATA (p2p.h)

Uma estrutura PEER_GRAPH_EVENT_DATA aponta para a estrutura de 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 um vizinho ou conexão 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;

Members

dwSize

Especifica o tamanho de uma estrutura.

status

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

Value Meaning
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 outra conexão 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 para o 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.

Value Description
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.

Requirements

Requirement Value
Cliente mínimo suportado 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 compatível Nenhum compatível
Header p2p.h

Consulte também

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA

  • Last updated on