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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetPresenceInfo(
  [in]  PCPEER_ENDPOINT     pcEndpoint,
  [out] PPEER_PRESENCE_INFO *ppPresenceInfo
);

Параметры

[in] pcEndpoint

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

[out] ppPresenceInfo

Указатель на адрес структуры PEER_PRESENCE_INFO , содержащей запрошенные данные о присутствии для указанной конечной точки.

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

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

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для поддержки этой операции.
E_INVALIDARG
 Один из аргументов недопустим.
PEER_E_NOT_INITIALIZED
 Приложение не выполняло предыдущий вызов PeerCollabStartup.
PEER_E_NOT_FOUND
 Сведения о присутствии для указанной конечной точки не найдены в одноранговой сети совместной работы.

Комментарии

Чтобы получить одноранговый объект, выполните приведенные далее действия.

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

Требования

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

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

PEER_CONTACT

PEER_ENDPOINT

PEER_PRESENCE_INFO

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