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

# SetDefaultApp

> IXtfApplicationClient::SetDefaultApp

# IXtfApplicationClient::SetDefaultApp

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

## 语法

```cpp theme={null}
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 主题)](https://docs.xbox.com/zh-CN/tools/tools-console/commandlinetools/xbapp.md)。

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

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

> [!NOTE]
>
> 当标题调用 [XLaunchNewGame](https://docs.xbox.com/zh-CN/reference/system/xgame/functions/xlaunchnewgame.md) 时，默认值将暂时被覆盖为当前正在运行的标题版本的 AUMID，以确保在重启时启动相同的版本。

## 要求

**头文件：** xtfapplication.h

**库：** xtfapplication.lib

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

## 另请参阅

[IXtfApplicationClient Interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)\
[XtfApplication](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/xtfapplication-xbox-microsoft-n.md)


## Related topics

- [IXtfApplicationClient 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/ixtfapplicationclient-xtfapplication-xbox-microsoft-t.md)
- [SetDefaultConsole](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [XSpeechSynthesizerSetDefaultVoice](https://docs.xbox.com/zh-CN/reference/system/xspeechsynthesizer/functions/xspeechsynthesizersetdefaultvoice.md)
- [Redeem Apple App Store Inventory Items](https://docs.xbox.com/api-reference/inventory/redeem-apple-app-store-inventory-items.md)
- [兑换 Apple App Store 库存物品](https://docs.xbox.com/zh-CN/services/playfab/api-references/rest/economy/inventory/redeem-apple-app-store-inventory-items.md)