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

Статья
08/25/2023

Функция PeerCollabExportContact экспортирует контактные данные, связанные с именем однорангового узла, в буфер строки. Буфер содержит контактные данные в формате XML.

Функция PeerCollabAddContact позволяет использовать эту XML-строку другими одноранговыми узлами.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabExportContact(
  [in, optional]  PCWSTR pwzPeerName,
  [out, optional] PWSTR  *ppwzContactData
);

Параметры

[in, optional] pwzPeerName

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

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

[out, optional] ppwzContactData

Указатель на буфер строки с нулем, содержащий XML-данные контактов одноранговых узлов, где имена одноранговых узлов соответствуют строке, указанной в pwzPeerName.

Возвращаемую здесь память можно освободить, вызвав PeerFreeData.

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

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

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

Требования

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

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

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

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