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

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

  • Статья

Функция PeerGraphGetNodeInfo извлекает сведения о конкретном узле.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
  [in]  HGRAPH          hGraph,
  [in]  ULONGLONG       ullNodeId,
  [out] PPEER_NODE_INFO *ppNodeInfo
);

Параметры

[in] hGraph

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

[in] ullNodeId

Указывает идентификатор узла, о котором приложение получает сведения. Укажите ноль (0), чтобы получить сведения о локальном узле.

[out] ppNodeInfo

Получает указатель на структуру PEER_NODE_INFO , содержащую запрошенные сведения. Если дескриптор не требуется, освободите его, вызвав PeerGraphFreeData.

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

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

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

Комментарии

На компьютере может быть несколько узлов графа. Например, несколько пользователей могли присоединить граф на определенном компьютере, поэтому сведения, возвращаемые PeerGraphGetNodeInfo , относятся к каждому узлу, а не к каждому компьютеру.

Требования

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

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

PEER_NODE_INFO

PeerGraphFreeData