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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplications(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [in, optional] const GUID      *pApplicationId,
  [out]          HPEERENUM       *phPeerEnum
);

Параметры

[in, optional] pcEndpoint

Указатель на структуру PEER_ENDPOINT , содержащую сведения о конечной точке для однорангового узла, приложения которого будут перечисляться.

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

[in, optional] pApplicationId

Указатель на значение GUID, которое однозначно идентифицирует конкретное приложение предоставленного однорангового узла. Если указан этот параметр, возвращается только одноранговое приложение, соответствующее этому GUID.

[out] phPeerEnum

Указатель на дескриптор для перечисленного набора зарегистрированных приложений, соответствующих ИДЕНТИФИКАТОРу GUID, возвращенному в pObjectId. Передайте этот дескриптор в PeerGetNextItem , чтобы получить каждый элемент в перечисленном наборе.

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

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

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

Комментарии

Чтобы успешно перечислить приложения для указанной конечной точки, данные приложения должны быть доступны в конечной точке. Чтобы данные приложения были доступны, необходимо выполнить одно из следующих действий:

  • Конечная точка должна быть ранее получена путем вызова PeerCollabEnumEndpoints.
  • Локальный одноранговый узел должен подписаться на конечную точку, вызвав PeerCollabSubscribeEndpointData.
  • Данные конечной точки должны быть обновлены путем успешного вызова PeerCollabRefreshEndpointData .

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

Элементы данных одноранговых приложений возвращаются в виде отдельных PEER_APPLICATION структур.

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

Требования

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

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

PEER_APPLICATION

PEER_CONTACT

PEER_ENDPOINT

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