IXtfApplicationClient::SetDefaultApp

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

语法

public:
HRESULT SetDefaultApp(
         LPCWSTR pszTitleId,
         LPCWSTR pszAumid
)  

参数

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 命令,而不是直接调用此方法。

默认应用程序用户模型 ID (AUMID) 用于pszAumid确定从 shell 启动游戏时或其他应用程序启动游戏时要启动哪个版本的应用程序。

注意

当游戏调用 XLaunchNewGame 时,将使用当前运行的游戏版本的 AUMID 暂时覆盖此默认值,以确保在重新启动时启动相同的版本。

要求

头文件:xtfapplication.h

库:xtfapplication.lib

支持平台:Windows(适用于 Xbox 主机工具)

另请参阅

IXtfApplicationClient 接口
XtfApplication