PeerCollabGetApplicationRegistrationInfo 函数 (p2p.h)

  • 项目

PeerCollabGetApplicationRegistrationInfo 函数获取特定于应用程序的注册信息。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetApplicationRegistrationInfo(
  [in]  const GUID                          *pApplicationId,
  [in]  PEER_APPLICATION_REGISTRATION_TYPE  registrationType,
  [out] PPEER_APPLICATION_REGISTRATION_INFO *ppApplication
);

参数

[in] pApplicationId

指向表示特定对等的应用程序注册标志的 GUID 值的指针。

[in] registrationType

一个PEER_APPLICATION_REGISTRATION_TYPE枚举值，该值描述是向当前用户还是向本地计算机的所有用户注册对等方应用程序。

[out] ppApplication

指向 PEER_APPLICATION_REGISTRATION_INFO 结构的地址的指针，该结构包含有关对等方的特定已注册应用程序的信息。 可以通过调用 PeerFreeData 来释放此参数中返回的数据。

返回值

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

返回代码 说明
E_OUTOFMEMORY
 没有足够的内存来支持此操作。
E_INVALIDARG
 其中一个参数无效。
PEER_E_NOT_FOUND
 请求的应用程序未为给定 registrationType 注册。

注解

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

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

要求

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

另请参阅

PEER_APPLICATION_REGISTRATION_INFO

PEER_APPLICATION_REGISTRATION_TYPE

对等协作 API 函数

PeerCollabRegisterApplication

PeerCollabUnregisterApplication