PeerGraphEnumNodes 函数 (p2p.h)
PeerGraphEnumNodes 函数创建并返回用于枚举对等图中的节点的枚举句柄。 枚举在执行枚举时提供对等图的快照。 根据对等图的策略，如果节点不发布状态信息，枚举不会返回连接到对等图的某些节点。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
[in] HGRAPH hGraph,
[in] PCWSTR pwzPeerId,
[out] HPEERENUM *phPeerEnum
);
参数
[in] hGraph
对等图的句柄。
[in] pwzPeerId
用于获取节点枚举的对等 ID。 指定 NULL 可返回对等图中的所有节点。
[out] phPeerEnum
接收枚举的句柄。 使用 PeerGraphGetNextItem 检索实际节点信息。 如果不需要此句柄，请通过调用 PeerGraphEndEnumeration 来释放它。
返回值
如果函数调用成功，则返回值 S_OK。 否则，它将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
一个参数无效。 |
|
没有足够的内存来执行指定的操作。 |
|
对等图的句柄无效。 |
|
必须先通过调用 PeerGraphStartup 初始化对等图，然后才能使用此函数。 |
|
对等图未完全同步，无法枚举节点。 |
|
对等图不需要状态信息。 因此，无法枚举节点。 |
注解
如果使用 PeerGraphEnumNodes 返回的句柄调用 PeerGraphGetNextItem，则 PeerGraphGetNextItem 返回PEER_NODE_INFO结构中的数据。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2PGraph.lib |
| DLL | P2PGraph.dll |