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


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

Функция PeerGroupEnumConnections создает перечисление подключений, активных в данный момент на одноранговом узле.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupEnumConnections(
  [in]  HGROUP    hGroup,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Параметры

[in] hGroup

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

[in] dwFlags

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

[out] phPeerEnum

Указатель на перечисление, содержащее возвращенный список активных подключений. Этот дескриптор передается в
PeerGetNextItem для извлечения элементов, каждый из которых представлен в виде указателя на PEER_CONNECTION_INFO структуру. По завершении вызывается PeerEndEnumeration для возврата памяти, используемой перечислением. Это обязательный параметр.

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

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

Код возврата Описание
E_INVALIDARG
Один из параметров недопустим.
E_OUTOFMEMORY
Недостаточно памяти для выполнения указанной операции.
PEER_E_INVALID_GROUP
Дескриптор одноранговой группы недопустим.
 

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

Требования

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

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

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem