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

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
  [in] HGROUP        hGroup,
  [in] ULONG         cAddresses,
  [in] PPEER_ADDRESS pAddresses
);

Параметры

[in] hGroup

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

[in] cAddresses

Общее количество PEER_ADDRESS структур, на которые указывает pAddresses.

[in] pAddresses

Указатель на список PEER_ADDRESS структур, определяющих конечные точки одноранговых узлов, участвующих в группе.

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

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

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

 

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

Комментарии

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

Требования

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

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

PEER_ADDRESS

PeerGroupConnect

PeerGroupJoin

PeerGroupPasswordJoin