Функция PeerCollabSetObject (p2p.h)
Функция PeerCollabSetObject создает или обновляет одноранговый объект данных, используемый в одноранговой сети совместной работы.
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
[in] PCPEER_OBJECT pcObject
);
[in] pcObject
Указатель на PEER_OBJECT структуру, содержащую одноранговый объект в одноранговой сети совместной работы.
Возвращает S_OK, если функция выполнена успешно. В противном случае функция возвращает одно из следующих значений.
Код возврата | Описание |
---|---|
|
Недостаточно памяти для поддержки этой операции. |
|
Один из аргументов является недопустимым. |
|
Инфраструктура однорангового узла Windows не инициализирована. Требуется вызвать соответствующую функцию инициализации. |
|
Для выполнения операции требуется, чтобы пользователь выполнил вход. |
Одноранговые объекты — это элементы данных времени выполнения, связанные с определенным приложением, например изображением, аватаром, сертификатом или конкретным описанием. Размер каждого однорангового объекта должен быть меньше 16 КБ и не может быть 0.
Если объект уже опубликован, PeerCollabSetObject обновит существующие данные объекта. Последнее приложение, обновляющее объект, будет владеть объектом . В результате, если приложение завершено, объект удаляется.
Если состояние объекта "опубликовано" удаляется из-за выхода, а не закрытия связанного приложения, приложение отвечает за публикацию объекта при следующем входе пользователя.
Доверенные контакты, наблюдающие за этим одноранговым объектом, будут иметь локальное событие PEER_EVENT_OBJECT_CHANGED , сигналив об изменении состояния этого однорангового объекта.
PeerCollabSetObject можно использовать для публикации не более 128 объектов.
В любой момент времени публикуется один объект с заданным ИДЕНТИФИКАТОРом GUID .
Требование | Значение |
---|---|
Минимальная версия клиента | Windows Vista [только классические приложения] |
Минимальная версия сервера | Ни одна версия не поддерживается |
Целевая платформа | Windows |
Header | p2p.h |
Библиотека | P2P.lib |
DLL | P2P.dll |