PeerEnumIdentities 函数 (p2p.h)

PeerEnumIdentities 函数创建并返回用于枚举属于特定用户的所有对等标识的对等枚举句柄。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerEnumIdentities(
  [out] HPEERENUM *phPeerEnum
);

[out] phPeerEnum

接收包含对等标识列表的对等枚举的句柄，其中每个项表示为指向PEER_NAME_PAIR 结构的指针。将此句柄传递给 PeerGetNextItem 以检索项;完成后，调用 PeerEndEnumeration 以释放内存。

如果函数调用成功，则返回值S_OK。否则，它将返回以下值之一。

返回代码	说明
E_INVALIDARG	其中一个参数无效。
E_OUTOFMEMORY	没有足够的内存来执行指定的操作。

应用程序获取对等枚举句柄后，请使用 PeerGetNextItem 和 PeerGetItemCount 枚举对等标识。

枚举对等标识时， PeerGetNextItem 返回指向 PEER_NAME_PAIR 结构的指针数组。

调用 PeerEndEnumeration 以在不再需要枚举句柄时释放枚举句柄。

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