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

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

  • Статья

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

Синтаксис

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

Параметры

[in] hGroup

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

[in] dwFlags

Задает флаги PEER_MEMBER_FLAGS , указывающие, какие типы элементов следует включить в перечисление. Если это значение равно нулю, включаются все члены одноранговой группы.

Значение Значение
PEER_MEMBER_PRESENT
 Перечисление всех членов текущей одноранговой группы, которые находятся в сети.

[in] pwzIdentity

Строка Юникода, содержащая удостоверение определенного однорангового узла, сведения которого извлекаются и возвращаются в перечислении из одного элемента. Если этот параметр имеет значение NULL, извлекаются все члены текущей одноранговой группы. Это обязательный параметр.

[out] phPeerEnum

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

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

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

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

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

Комментарии

Локальный узел всегда является самым первым элементом перечисления, если pwzIdentity имеет значение NULL, а dwFlags указывает, что локальный узел является членом явного подмножества.

По умолчанию каждый участник публикует сведения о членстве в одноранговой группе. Если PEER_MEMBER_DATA_OPTIONAL задано для PEER_MEMBER данных для этого однорангового узла, эти сведения доступны только при выполнении одноранговым элементом действия в группе, например публикации записи, обновления присутствия или выдачи GMC.

Требования

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

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

PeerEndEnumeration

PeerGetItemCount

PeerGetNextItem