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