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

# SetDefaultConsole

> Método IXtfConsoleManager::SetDefaultConsole

# Método IXtfConsoleManager::SetDefaultConsole

Define o console de desenvolvimento padrão para as ferramentas e a API do XBOX Tools Framework (XTF).

## Sintaxe

```cpp theme={null}
public:
HRESULT SetDefaultConsole(
         LPCWSTR pszAlias
)  
```

### Parâmetros

*pszAlias*\
Tipo: LPCWSTR

Um ponteiro para o nome do console de desenvolvimento a ser definido como o console de desenvolvimento padrão.

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

## Comentários

Esse método define o console de desenvolvimento com o alias especificado em `pszAlias` da instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) como o console de desenvolvimento padrão a ser usado com as ferramentas e a API do XBOX Tools Framework (XTF) neste PC.

Depois que esse método for chamado com êxito, a instância de `IXtfConsoleManager` invocará o método de retorno de chamada [OnChangedDefaultConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md) da instância associada de [IXtfConsoleManagerCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md).

Para obter mais informações sobre como conectar e consultar consoles de desenvolvimento, consulte [Conectar (xbconnect.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md).

## Requisitos

**Cabeçalho:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

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

## Confira também

[Interface IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)\
[XtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)


## Related topics

- [OnChangedDefaultConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [XtfGetDefaultAddress](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)
- [XtfGetSavedConsoleAddress](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfapi/functions/xtfgetsavedconsoleaddress-xtfapi-xbox-windows-m.md)
- [Interface IXtfConsoleManager (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [AddConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)