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 初始化对等图，然后才能使用此函数。

使用 PeerGraphEnumConnections 返回的枚举句柄调用 PeerGraphGetNextItem 时，PeerGraphGetNextItem 返回PEER_CONNECTION_INFO结构。

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