peerEnumGroups 函数 (p2p.h)
PeerEnumGroups 函数创建并返回一个对等枚举句柄，该句柄用于枚举与特定对等标识关联的所有对等组。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumGroups(
[in] PCWSTR pwzIdentity,
[out] HPEERENUM *phPeerEnum
);
参数
[in] pwzIdentity
指定要枚举组的对等标识。
[out] phPeerEnum
接收对等枚举的句柄，该对等枚举包含指定标识所属的对等组的列表，每个项表示为 指向PEER_NAME_PAIR 结构的指针。 将此句柄传递给 PeerGetNextItem 以检索项;完成后，调用 PeerEndEnumeration 释放内存。
返回值
如果函数调用成功，则返回值S_OK。 否则，它将返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
其中一个参数无效。 |
|
内存不足，无法执行指定的操作。 |
|
找不到指定的对等标识。 |
注解
应用程序获取枚举句柄后，使用 PeerGetNextItem 和 PeerGetItemCount 枚举对等组。
枚举对等组时， PeerGetNextItem 返回指向 PEER_NAME_PAIR 结构的指针数组。
调用 PeerEndEnumeration 以在不再需要对等枚举句柄时释放该句柄。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 和适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |