XLaunchUri

Microsoft 游戏开发工具包(GDK) API 提供了一种机制,使游戏能够通过调用 URI 来启动体验。

语法

HRESULT XLaunchUri(  
         XUserHandle requestingUser,  
         const char* uri  
)  

参数

requestingUser _In_opt_
类型:XUserHandle

定义一个句柄,标识提出请求的用户。

uri _In_z_
类型:char*

指示要启动的 URI 的字符串。

返回值

类型:HRESULT

HRESULT 成功或错误代码。

如果成功,则返回 S_OK;否则返回错误代码。 有关错误代码的列表,请参阅错误代码

备注

注意

在时间敏感线程上调用此函数是不安全的。 有关详细信息,请参阅时间敏感线程

这将代表用户启动 URI,并且只包含一个方法 LaunchUri。 它还接受可选的用户上下文和必需的 URI。

如果成功,则启动目标 URI。 否则,将返回错误。 此方法不被视为时间关键的,在基础异步系统操作完成之前将阻塞,并且目标 URI 或者已启动,或者发生了错误。

如果不存在用于处理给定 URI 的协议方案的应用,则系统将向用户显示一个提示,询问其是否要搜索 Windows Store 以找到处理该方案的应用程序。

要求

头文件:XLauncher.h

库:xgameruntime.lib

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

XLauncher