Поделиться через

структура PEER_EVENT_CONNECTION_CHANGE_DATA (p2p.h)

  • Статья

Структура PEER_GRAPH_EVENT_DATA указывает на структуру PEER_EVENT_CONNECTION_CHANGE_DATA , если активируется одноранговые события:

  • PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION
  • PEER_GRAPH_EVENT_DIRECT_CONNECTION
  • PEER_GROUP_EVENT_NEIGHBOR_CONNECTION
  • PEER_GROUP_EVENT_DIRECT_CONNECTION
Структура PEER_EVENT_CONNECTION_CHANGE_DATA содержит обновленные сведения, включая изменения в соседнем или прямом соединении.

Синтаксис

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;

Члены

dwSize

Задает размер структуры.

status

Указывает тип изменения в соседнем или прямом соединении. Допустимы следующие значения.

Значение Значение
PEER_CONNECTED
 Установлено новое входящее или исходящее подключение к локальному узлу.
PEER_CONNECTION_FAILED
 Не удалось подключиться к локальному узлу.

Одна попытка подключения может привести к нескольким сбоям подключения. Это произойдет после первоначального сбоя подключения, когда одноранговая инфраструктура устанавливает для элемента ullNextConnectionId идентификатор узла и пытается установить новое подключение. Если элемент ullNextConnectionId равен 0, дальнейшие подключения не будут предприниматься.
PEER_DISCONNECTED
 Существующее подключение было отключено.

ullConnectionId

Указывает уникальный идентификатор для измененного подключения.

ullNodeId

Указывает уникальный идентификатор измененного узла.

ullNextConnectionId

Windows Vista или более поздней версии. Содержит следующий доступный идентификатор узла, к которому будут пытаться подключиться API группирования или графирования при сбое подключения. Если этот элемент имеет значение 0, дальнейшие подключения не будут предприниматься.

hrConnectionFailedReason

Windows Vista или более поздней версии. Указывает тип ошибки при сбое подключения. hrConnectionFailedReason может возвращать следующие коды ошибок.

Значение Описание
PEER_E_CONNECTION_REFUSED Соединение было установлено и отклонено. Удаленный узел уже имеет максимальное количество подключений или подключение уже существует.
PEER_E_CONNECTION_FAILED Не удалось подключиться к удаленному узлу.
PEER_E_CONNECTION_NOT_AUTHENTICATED Подключение будет потеряно на этапе проверки подлинности. Это происходит в результате сбоя сети или разрыва подключения на удаленном узле.

Требования

   
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Верхняя часть p2p.h

См. также раздел

PEER_GRAPH_EVENT_DATA

PEER_GROUP_EVENT_DATA