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

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

  • Статья

Функция PeerGraphEnumNodes создает и возвращает дескриптор перечисления, используемый для перечисления узлов в одноранговом графе. Перечисление предоставляет snapshot однорангового графа во время выполнения перечисления. В зависимости от политики однорангового графа и от того, не публикуют ли узлы сведения о присутствии, перечисление не возвращает некоторые узлы, подключенные к одноранговой диаграмме.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Параметры

[in] hGraph

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

[in] pwzPeerId

Идентификатор однорангового узла для получения перечисления узла. Укажите ЗНАЧЕНИЕ NULL , чтобы вернуть все узлы в одноранговом графе.

[out] phPeerEnum

Получает дескриптор перечисления. Используйте PeerGraphGetNextItem для получения фактических сведений об узле. Если этот дескриптор не требуется, освободите его, вызвав PeerGraphEndEnumeration.

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

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

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

Комментарии

Если метод PeerGraphGetNextItem вызывается с дескриптором, который возвращает PeerGraphEnumNodes , то PeerGraphGetNextItem возвращает данные в структуре PEER_NODE_INFO .

Требования

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

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

PEER_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem