PeerCollabEnumPeopleNearMe 函数 (p2p.h)

  • 项目

PeerCollabEnumPeopleNearMe 函数返回枚举集的句柄，该枚举集包含所有对等协作网络“我附近的人员”终结点，这些终结点当前在调用对等方的子网上可用。

语法

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

参数

[out] phPeerEnum

指向枚举集的句柄的指针，该集合包含调用对等方子网上当前可用的所有对等协作网络“我附近的人员”终结点。

返回值

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

返回代码 说明
E_OUTOFMEMORY
 内存不足，无法支持此操作。
E_INVALIDARG
 其中一个参数无效。
PEER_E_NOT_INITIALIZED
 Windows 对等基础结构未初始化。 需要调用相关的初始化函数。
PEER_E_NOT_SIGNED_IN
 该操作要求用户登录。

注解

若要获取单个对等“我附近的人员”联系人，请将返回的句柄传递给 PeerGetNextItem。 返回指向 PEER_PEOPLE_NEAR_ME 结构的指针数组。 若要关闭枚举并释放与其关联的资源，请将此句柄传递给 PeerEndEnumeration。 枚举返回的各个项必须使用 PeerFreeData 释放。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

PEER_PEOPLE_NEAR_ME

对等协作 API 函数

PeerCollabSignin