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 主机