PeerCollabEnumContacts 函数 (p2p.h)

PeerCollabEnumContacts 函数返回枚举集的句柄，该集包含呼叫对等方上当前可用的所有对等协作网络联系人。

语法

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

[out] phPeerEnum

枚举集的句柄，该集包含呼叫对等方上当前可用的所有对等协作网络联系人，不包括“Me”联系人。

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

返回代码	说明
E_OUTOFMEMORY	没有足够的内存来支持此操作。
E_INVALIDARG	其中一个参数无效。
PEER_E_NOT_INITIALIZED	Windows 对等基础结构未初始化。需要调用相关的初始化函数。

若要获取单个对等联系人，请将返回的句柄传递给 PEER_CONTACT 将返回结构。若要关闭枚举并释放与之关联的资源，请将此句柄传递给 PeerEndEnumeration。枚举返回的各个项必须使用 PeerFreeData 释放。