PeerCollabEnumApplicationRegistrationInfo 函数 (p2p.h)

  • 项目

PeerCollabEnumApplicationRegistrationInfo 函数获取用于检索对等应用程序信息的枚举句柄。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabEnumApplicationRegistrationInfo(
  [in]  PEER_APPLICATION_REGISTRATION_TYPE registrationType,
  [out] HPEERENUM                          *phPeerEnum
);

参数

[in] registrationType

一个 PEER_APPLICATION_REGISTRATION_TYPE 值，该值指定是向当前用户还是向对等计算机的所有用户注册对等方的应用程序。

[out] phPeerEnum

指向对等应用程序注册信息的对等枚举句柄的指针。 此数据是通过将此句柄传递给 PeerGetNextItem 获取的。

返回值

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

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

注解

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

应用程序是对等终结点上可用的一组软件或软件功能。 通常，这是指支持对等网络活动的软件包，例如游戏或其他协作应用程序。

对等方的应用程序具有表示单个特定应用程序的 GUID。 为对等方注册应用程序时，此 GUID 和相应的应用程序可以提供给对等方的所有受信任联系人，指示对等方可以参与的活动。 若要注销对等方的应用程序，请使用此 GUID 调用 PeerCollabUnregisterApplication 。

对等应用程序注册信息项作为单个 PEER_APPLICATION_REGISTRATION_INFO 结构返回。

要求

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

另请参阅

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

对等协作 API 函数

PeerCollabUnregisterApplication