Функция 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