Функция PeerCollabAddContact (p2p.h)
Функция PeerCollabAddContact добавляет контакт в список контактов однорангового узла.
Синтаксис
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabAddContact(
[in] PCWSTR pwzContactData,
[out, optional] PPEER_CONTACT *ppContact
);
Параметры
[in] pwzContactData
Указатель на буфер строки Юникода с нулем, содержащий контактные данные для однорангового узла, добавленного в список контактов. Этот буфер строк можно получить либо путем передачи имени однорангового узла конечной точки, добавляемой в качестве контакта в PeerCollabQueryContactData, либо с помощью внешнего механизма.
Чтобы отправить собственные контактные данные вне канала, одноранговый узел может вызвать PeerCollabExportContact с именем однорангового узла NULL . Эта функция возвращает контактные данные в формате XML.
[out, optional] ppContact
Указатель на указатель на структуру PEER_CONTACT . Этот параметр получает адрес структуры PEER_CONTACT , содержащей контактные данные однорангового узла для контакта, указанного в pwzContactData. Этот параметр может иметь значение NULL.
Вызовите PeerFreeData по адресу структуры PEER_CONTACT , чтобы освободить эти данные.
Возвращаемое значение
Возвращает S_OK, если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
| Код возврата | Описание |
|---|---|
|
Недостаточно памяти для поддержки этой операции. |
|
Один из аргументов является недопустимым. |
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Ни одна версия не поддерживается |
| Целевая платформа | Windows |
| Header | p2p.h |
| Библиотека | P2P.lib |
| DLL | P2P.dll |