> ## 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

Define a ID do aplicativo a ser iniciado quando uma solicitação de ativação é recebida para uma ID de título específica.

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*pszTitleId*\
Tipo: LPCWSTR

O esquema de ID de título cujos padrões serão alterados.

*pszAumid*\
Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres que contém o AUMID do aplicativo a ser iniciado.

<a id="retvalSection" />

### Valor de retorno

Tipo: HRESULT

Retorna `S_OK` se tiver êxito; caso contrário, retorna um código de erro HRESULT.

<a id="remarksSection" />

## Comentários

Este método define a ID do aplicativo a ser iniciado quando uma solicitação de ativação é recebida para uma ID de título específica. Este método é semelhante ao comando `xbapp setdefaultapp` da ferramenta Gerenciamento de aplicativos (xbapp.exe), incluída como parte do XBOX Tools Framework (XTF). Para obter mais informações sobre o comando `xbapp setdefaultapp`, confira [Gerenciamento de aplicativos (xbapp.exe) (tópico sob NDA)](/pt-BR/tools/tools-console/commandlinetools/xbapp).

<Note>Para maximizar a compatibilidade futura, suas ferramentas devem usar o comando `xbapp setdefaultapp` da ferramenta Gerenciamento de aplicativos, em vez de invocar este método diretamente.</Note>

A App User Model ID (AUMID) padrão especificada em `pszAumid` determina qual versão de um aplicativo será iniciada quando um jogo for iniciado pelo shell ou quando outro aplicativo iniciar o jogo.

<Note>Quando um título chama [XLaunchNewGame](/pt-BR/reference/system/xgame/functions/xlaunchnewgame), o valor padrão é substituído temporariamente pelo AUMID da versão do título em execução no momento, para garantir que a mesma versão seja iniciada na reinicialização.</Note>

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfapplication.h

**Biblioteca:** xtfapplication.lib

**Plataformas com suporte:** Windows (para ferramentas de console XBOX)

<a id="seealsoSection" />

## Confira também

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


## Related topics

- [Método IXtfApplicationClient::MarkAppAsProvisioned](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/markappasprovisioned-ixtfapplicationclient-xtfapplication.md)
- [IXtfApplicationClient::Constrain](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/constrain-ixtfapplicationclient-xtfapplication-xbox-windows-m.md)
- [IXtfApplicationClient::Deploy](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/deploy-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Launch](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/launch-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)
- [IXtfApplicationClient::Resume](/pt-BR/reference/tools/xtf/xtfapplication/classes/IXtfApplicationClient/methods/resume-ixtfapplicationclient-xtfapplication-xbox-microsoft-m.md)