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

Статья
03/15/2023

Структура 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

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