Функция PeerGroupConnect (p2p.h)

Статья
03/15/2023

Функция PeerGroupConnect инициирует поиск одноранговой группы PNRP и пытается подключиться к ней. После успешного вызова этой функции одноранговый узел может взаимодействовать с другими членами группы одноранговых узлов.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

Параметры

[in] hGroup

Дескриптор группы одноранговых узлов, к которой планирует подключиться одноранговый узел. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen, PeerGroupJoin или PeerGroupPasswordJoin . Это обязательный параметр.

Возвращаемое значение

Возвращает S_OK, если операция выполнена успешно. В противном случае функция возвращает следующее значение.

Код возврата	Описание
PEER_E_INVALID_GROUP	Дескриптор группы одноранговых узлов недопустим.

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Приложение регистрирует события однорангового узла перед вызовом этой функции. Если вызов функции завершается неудачно, возникает событие PEER_GROUP_EVENT_CONNECTION_FAILED. В противном случае возникает событие PEER_GROUP_EVENT_STATUS_CHANGED.

Событие PEER_GROUP_EVENT_CONNECTION_FAILED также возникает, когда создателю группы не удается вызвать PeerGroupConnect сразу после создания. Если этого не произойдет, пользователи, получив приглашение, успешно вызовут PeerGroupConnect , но не смогут прослушать и в конечном итоге получат событие сбоя подключения.

В случае неравномерного распределения часов между участвующими компьютерами успех PeerGroupConnect может зависеть от серьезности неравномерного распределения. При устранении неполадок при сбое присоединения следует учитывать эту возможность, убедившись, что часы компьютера синхронизированы.

Чтобы присутствовать в одноранговой группе и получать события, но оставаться несвязанными, используйте функцию PeerGroupOpen .

Если значение времени ожидания для PeerGroupConnect не указано в приложении, при возникновении сбоя приложение зависнет. Рекомендуется использовать время ожидания в 30 секунд.

Перед вызовом PeerGroupConnect группа существует в состоянии "Отключено". В течение этого времени группа не может быть обнаружена или получена подключения. Чтобы вернуть группу в это состояние, необходимо вызвать функцию PeerGroupClose .

Требования

Требование	Значение
Минимальная версия клиента	Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	p2p.h
Библиотека	P2P.lib
DLL	P2P.dll

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

PeerGroupClose

PeerGroupJoin

PeerGroupОткрыть

PeerGroupPasswordJoin

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