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

Статья
08/25/2023

Функция 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	Для однорангового графа не требуются сведения о присутствии. Таким образом, узлы нельзя перечислить.

Требования

Требование	Значение
Минимальная версия клиента	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

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