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

Статья
03/15/2023

Функция 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

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