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

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

  • Статья

Функция PeerGraphSetPresence явно включает или отключает публикацию записей о присутствии для определенного узла. Эта функция может переопределять параметры присутствия в свойствах однорангового графа. Вызов этой функции позволяет перечислить узлы с помощью PeerGraphEnumNodes.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetPresence(
  [in] HGRAPH hGraph,
  [in] BOOL   fPresent
);

Параметры

[in] hGraph

Дескриптор однорангового графа.

[in] fPresent

Задайте значение TRUE , чтобы инфраструктура однорангового графирования опубликовала запись о присутствии для этого узла, которая переопределяет параметр, заданный параметром cPresenceMax в PEER_GRAPH_PROPERTIES. Укажите ЗНАЧЕНИЕ FALSE , чтобы вернуть узлу поведение по умолчанию, указанное в свойствах однорангового графа.

Примечание В зависимости от политики присутствия однорангового графа параметр fPresent имеет значение FALSE , не гарантирует, что сведения о присутствии однорангового узла будут удалены. Это означает, что присутствие однорангового узла больше не публикуется.
 

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

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

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

Комментарии

Если сведения о присутствии не были явно опубликованы одноранговым графом, узлы не видны при перечислении однорангового графа.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2PGraph.lib
DLL P2PGraph.dll

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

PeerGraphEnumNodes