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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumEndpoints(
  [in]  PCPEER_CONTACT pcContact,
  [out] HPEERENUM      *phPeerEnum
);

Параметры

[in] pcContact

Указатель на структуру PEER_CONTACT , содержащую контактные данные для определенного однорангового узла. Этот параметр не должен иметь значение NULL.

[out] phPeerEnum

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

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

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

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для поддержки этой операции.
E_INVALIDARG
 Один из аргументов является недопустимым.
PEER_E_NOT_INITIALIZED
 Инфраструктура однорангового узла Windows не инициализирована. Требуется вызвать соответствующую функцию инициализации.
PEER_E_NOT_SIGNED_IN
 Для выполнения операции требуется, чтобы пользователь выполнил вход.

Комментарии

Перед вызовом PeerCollabEnumEndpoints рекомендуется обновить запись контакта с помощью PeerCollabUpdateContact. Невыполнение этого действия может привести к возврату E_INVALIDARG.

Конечные точки будут доступны только для контактов с fWatch , имеющим значение true. Будут доступны только те конечные точки, для которых контакт "Me" вызывающего однорангового узла сохранен в качестве доверенного контакта и для которых для параметра WatcherPermissionsзадано разрешение . Контакт также должен войти в Интернет. В случае, если контакт не вошел в систему, будет возвращена ошибка E_INVALIDARG .

Чтобы получить отдельные конечные точки однорангового узла, передайте возвращенный дескриптор в PeerGetNextItem. Будет возвращен массив указателей на PEER_ENDPOINT структуры. Если конечные точки недоступны, возвращается пустой массив. Чтобы закрыть перечисление и освободить связанные с ним ресурсы, передайте этот дескриптор в PeerEndEnumeration. Отдельные элементы, возвращаемые перечислением , должны быть освобождены с помощью PeerFreeData.

Ограничение для подключений к одному контакту — 50.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2P.lib
DLL P2P.dll

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

PEER_ENDPOINT

Функции API одноранговой совместной работы