Функция 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, если операция выполнена успешно. В противном случае функция возвращает следующее значение.
| Код возврата | Описание |
|---|---|
|
Дескриптор группы одноранговых узлов недопустим. |
Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком 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 |