PeerCollabRegisterApplication 函数 (p2p.h)

  • 项目

PeerCollabRegisterApplication 函数将应用程序注册到本地计算机，以便可以在对等协作活动中启动该应用程序。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterApplication(
  [in] PCPEER_APPLICATION_REGISTRATION_INFO pcApplication,
  [in] PEER_APPLICATION_REGISTRATION_TYPE   registrationType
);

参数

[in] pcApplication

指向 PEER_APPLICATION_REGISTRATION_INFO 结构的指针，该结构包含对等方的应用程序功能集的 UUID 以及任何其他特定于对等方的数据。

[in] registrationType

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

返回值

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

返回代码 说明
E_OUTOFMEMORY
 没有足够的内存来支持此操作。
E_INVALIDARG
 其中一个参数无效。

注解

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

协作基础结构可以接收来自受信任联系人或“人员近我”的应用程序邀请，这基于协作基础结构使用 PeerCollabSignin 登录的范围。

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

注册应用程序时，建议开发人员指定相对路径（如 %ProgramFiles%），而不是绝对路径。 这可以防止应用程序文件位置发生更改而导致应用程序失败。 例如，如果将 C：\ProgramFiles 目录移动到 E：\。

只能注册计算机本地应用程序。 当应用程序的可执行路径位于网络共享（如 UNC 路径或本地映射的网络驱动器）上时，无法注册。

可以在“ALL_USERS”和“CURRENT_USER”范围内注册应用程序。 如果应用程序同时在这两个范围内注册，在“CURRENT_USER”范围内注册的应用程序优先于在“ALL_USERS”范围内注册的应用程序。 请务必注意，若要注册“ALL_USERS”注册类型，调用方必须具有管理权限。

可以为特定 registrationType 注册的最大应用程序数为 64。

要求

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

另请参阅

PEER_APPLICATION_REGISTRATION_TYPE

对等协作 API 函数

PeerCollabUnregisterApplication