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

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

  • Статья

Функция PeerCollabQueryContactData извлекает контактные данные для указанной конечной точки однорангового узла.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabQueryContactData(
  [in, optional] PCPEER_ENDPOINT pcEndpoint,
  [out]          PWSTR           *ppwzContactData
);

Параметры

[in, optional] pcEndpoint

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

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

[out] ppwzContactData

Указатель на буфер строки Юникода с нулевым завершением, который содержит контактные данные для конечной точки, предоставленной в pcEndpoint. Вызовите PeerFreeData , чтобы освободить данные.

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

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

Код возврата Описание
E_OUTOFMEMORY
 Недостаточно памяти для поддержки этой операции.
E_INVALIDARG
 Один из аргументов является недопустимым.
PEER_E_NOT_FOUND
 Запрошенные контактные данные не существуют. Попробуйте вызвать PeerCollabRefreshEndpointData , прежде чем предпринять еще одну попытку.

Комментарии

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

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

Требования

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

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

PEER_ENDPOINT

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