跳转到主要内容

IXtfApplicationClient::SetDefaultApp

设置在收到特定标题 ID 的激活请求时要启动的应用程序的 ID。

语法

参数

pszTitleId
类型:LPCWSTR
要更改默认值的标题 ID 方案。 pszAumid
类型:LPCWSTR
指向包含要启动的应用的 AUMID 的字符串的指针。

返回值

类型:HRESULT 如果成功则返回 S_OK;否则返回 HRESULT 错误代码。

备注

此方法设置在收到特定标题 ID 的激活请求时要启动的应用程序的 ID。此方法类似于 XBOX Tools Framework (XTF) 中包含的应用程序管理 (xbapp.exe) 工具的 xbapp setdefaultapp 命令。有关 xbapp setdefaultapp 命令的详细信息,请参阅应用程序管理 (xbapp.exe) (NDA 主题)。
为最大程度地兼容未来版本,你的工具应使用应用程序管理工具中的 xbapp setdefaultapp 命令,而不是直接调用此方法。
在 pszAumid 中指定的默认应用程序用户模型 ID (AUMID) 确定从 shell 启动游戏或从另一个应用启动游戏时要启动应用程序的哪个版本。
当标题调用 XLaunchNewGame 时,默认值将暂时被覆盖为当前正在运行的标题版本的 AUMID,以确保在重启时启动相同的版本。

要求

头文件: xtfapplication.h 库: xtfapplication.lib 支持的平台: Windows(用于 XBOX 主机工具)

另请参阅

IXtfApplicationClient Interface
XtfApplication
最后修改于 2026年10月20日