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

Функция PeerCollabSetObject создает или обновляет одноранговый объект данных, используемый в одноранговой сети совместной работы.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

Параметры

[in] pcObject

Указатель на PEER_OBJECT структуру, содержащую одноранговый объект в одноранговой сети совместной работы.

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

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

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

Комментарии

Одноранговые объекты — это элементы данных времени выполнения, связанные с определенным приложением, например изображением, аватаром, сертификатом или конкретным описанием. Размер каждого однорангового объекта должен быть меньше 16 КБ и не может быть 0.

Если объект уже опубликован, PeerCollabSetObject обновит существующие данные объекта. Последнее приложение, обновляющее объект, будет владеть объектом . В результате, если приложение завершено, объект удаляется.

Если состояние объекта "опубликовано" удаляется из-за выхода, а не закрытия связанного приложения, приложение отвечает за публикацию объекта при следующем входе пользователя.

Доверенные контакты, наблюдающие за этим одноранговым объектом, будут иметь локальное событие PEER_EVENT_OBJECT_CHANGED , сигналив об изменении состояния этого однорангового объекта.

PeerCollabSetObject можно использовать для публикации не более 128 объектов.

В любой момент времени публикуется один объект с заданным ИДЕНТИФИКАТОРом GUID .

Требования

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

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

PEER_OBJECT

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