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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
  [in] PCPEER_PRESENCE_INFO pcPresenceInfo
);

Параметры

[in] pcPresenceInfo

Указатель на структуру PEER_PRESENCE_INFO , содержащую новые сведения о присутствии для публикации для вызывающего однорангового приложения.

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

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

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

Комментарии

Контакты, наблюдающие за присутствием этого однорангового узла, будут иметь локальное событие PEER_EVENT_PRESENCE_CHANGED, которое сигнализирует об изменении состояния присутствия этого однорангового узла. Состояние присутствия однорангового узла не может быть установлено в автономном режиме при входе в систему. По умолчанию состояние присутствия однорангового узла — "в сети", а описательный текст — NULL при входе.

Любой описательный текст для состояния присутствия ограничен 255 символами Юникода.

Требования

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

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

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