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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumConnections(
  [in]  HGRAPH    hGraph,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Параметры

[in] hGraph

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

[in] dwFlags

Тип соединения для перечисления. Это обязательный параметр. Допустимые значения задаются PEER_CONNECTION_FLAGS.

[out] phPeerEnum

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

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

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

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

Комментарии

При вызове PeerGraphGetNextItem с дескриптором перечисления, возвращенным PeerGraphEnumConnections, PeerGraphGetNextItem возвращает PEER_CONNECTION_INFO структуру.

Требования

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

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

PEER_CONNECTION_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem