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

Статья
08/25/2023

Функция PeerCollabGetContact получает сведения о одноранговом контакте по имени однорангового узла.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetContact(
  [in, optional]  PCWSTR        pwzPeerName,
  [out, optional] PPEER_CONTACT *ppContact
);

Параметры

[in, optional] pwzPeerName

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

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

[out, optional] ppContact

Указатель на указатель на структуру PEER_CONTACT . Он получает адрес структуры PEER_CONTACT, содержащей контактные данные однорангового узла для имени однорангового узла, указанного в pwzPeerName. Если этот параметр имеет значение NULL, эта функция возвращает E_INVALIDARG.

Вызовите PeerFreeData по адресу структуры PEER_CONTACT , чтобы освободить эти данные.

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

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

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

Требования

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

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

PEER_CONTACT

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

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