> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IXtfApplicationClient::SetDefaultApp

> IXtfApplicationClient::SetDefaultApp

# IXtfApplicationClient::SetDefaultApp

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

<a id="syntaxSection" />

## 语法

```cpp theme={null}
public:
HRESULT SetDefaultApp(
         LPCWSTR pszTitleId,
         LPCWSTR pszAumid
)  
```

<a id="parametersSection" />

### 参数

*pszTitleId*\
类型：LPCWSTR

要更改默认值的标题 ID 方案。

*pszAumid*\
类型：LPCWSTR

指向包含要启动的应用的 AUMID 的字符串的指针。

<a id="retvalSection" />

### 返回值

类型：HRESULT

如果成功则返回 `S_OK`；否则返回 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

此方法设置在收到特定标题 ID 的激活请求时要启动的应用程序的 ID。此方法类似于 XBOX Tools Framework (XTF) 中包含的应用程序管理 (xbapp.exe) 工具的 `xbapp setdefaultapp` 命令。有关 `xbapp setdefaultapp` 命令的详细信息，请参阅[应用程序管理 (xbapp.exe) (NDA 主题)](/tools/tools-console/commandlinetools/xbapp)。

<Note>为最大程度地兼容未来版本，你的工具应使用应用程序管理工具中的 `xbapp setdefaultapp` 命令，而不是直接调用此方法。</Note>

在 `pszAumid` 中指定的默认应用程序用户模型 ID (AUMID) 确定从 shell 启动游戏或从另一个应用启动游戏时要启动应用程序的哪个版本。

<Note>当标题调用 [XLaunchNewGame](/reference/system/xgame/functions/xlaunchnewgame) 时，默认值将暂时被覆盖为当前正在运行的标题版本的 AUMID，以确保在重启时启动相同的版本。</Note>

<a id="requirementsSection" />

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

**支持的平台：** Windows（用于 XBOX 主机工具）

<a id="seealsoSection" />

## 另请参阅

[IXtfApplicationClient Interface](/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t)\
[XtfApplication](/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n)


## Related topics

- [IXtfApplicationClient::Constrain](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Deploy](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Unconstrain](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/unconstrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Uninstall](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/uninstall-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Launch](/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)