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


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

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumContacts(
  [out] HPEERENUM *phPeerEnum
);

Параметры

[out] phPeerEnum

Дескриптор перечисленного набора, который содержит все контакты сети совместной работы одноранговых узлов, доступные в настоящее время на вызывающем одноранговом узле, за исключением контакта "Me".

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

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

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

Комментарии

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

Требования

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

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

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