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

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

  • Статья

Функция PeerCollabSubscribeEndpointData создает подписку на доступную конечную точку.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
  [in] const PCPEER_ENDPOINT pcEndpoint
);

Параметры

[in] pcEndpoint

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

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

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

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

Комментарии

PeerCollabSubscribeEndpointData является асинхронным вызовом, что означает, что процесс подписки на конечную точку запущен, но не обязательно завершен при возврате этого вызова. Приложение должно ожидать, пока PEER_EVENT_REQUEST_STATUS_CHANGED получит результат запроса на подписку.

Время ожидания этой функции составит 30 секунд.

PeerCollabSubscribeEndpointData можно вызывать несколько раз из разных приложений для одной конечной точки. Каждый вызов учитывается; только при освобождении последней ссылки одноранговый узел отменяется. Чтобы освободить ссылку, вызовите PeerCollabUnsubscribeEndpointData.

Когда приложение завершает работу без вызова PeerCollabUnsubscribeEndpointData, все ссылки для этого приложения освобождаются автоматически.

Чтобы успешно вызвать API PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects и PeerCollabQueryContactData , приложение должно сначала вызвать PeerCollabSubscribeEndpointData.

Требования

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

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

PeerCollabEnumApplications

PeerCollabEnumObjects

PeerCollabGetPresenceInfo

PeerCollabQueryContactData

PeerCollabUnsubscribeEndpointData