Функция PeerEnumGroups (p2p.h)
Функция PeerEnumGroups создает и возвращает дескриптор перечисления одноранговых узлов, используемый для перечисления всех одноранговых групп, связанных с определенным удостоверением однорангового узла.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
Параметры
[in] pwzIdentity
Указывает удостоверение однорангового узла для перечисления групп.
[out] phPeerEnum
Получает дескриптор однорангового перечисления, содержащего список одноранговых групп, членом которых является указанное удостоверение, при этом каждый элемент представлен в виде указателя на структуру PEER_NAME_PAIR . Передайте этот дескриптор в PeerGetNextItem для получения элементов; По завершении вызовите PeerEndEnumeration освободить память.
Возвращаемое значение
Если вызов функции выполнен успешно, возвращаемое значение будет S_OK. В противном случае возвращается одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Один из параметров недопустим. |
|
Недостаточно памяти для выполнения указанной операции. |
|
Не удается найти указанное удостоверение однорангового узла. |
Комментарии
Получив дескриптор перечисления, используйте PeerGetNextItem и PeerGetItemCount для перечисления одноранговых групп.
При перечислении одноранговых групп PeerGetNextItem возвращает массив указателей на PEER_NAME_PAIR структуры.
Вызовите PeerEndEnumeration , чтобы освободить дескриптор перечисления одноранговых узлов, когда он больше не требуется.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP с пакетом обновления 2 (SP2) [только классические приложения],Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |