通过

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

指定应用程序接收相关信息的节点的 ID。 指定零 (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 返回的信息与每个节点有关，而不是每台计算机。

要求

要求 值
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2PGraph.lib
DLL P2PGraph.dll

另请参阅

PEER_NODE_INFO

PeerGraphFreeData