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

# AddConsole

> Método IXtfConsoleManager::AddConsole

# Método IXtfConsoleManager::AddConsole

Adiciona um console de desenvolvimento à instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md).

## Sintaxe

```cpp theme={null}
public:
HRESULT AddConsole(
         LPCWSTR pszAlias,
         LPCWSTR pszAddress,
         XTF_ADD_CONSOLE_FLAGS dwFlags
)  
```

### Parâmetros

*pszAlias*\
Tipo: LPCWSTR

Um ponteiro para o nome do console a ser adicionado.

*pszAddress*\
Tipo: LPCWSTR

Um ponteiro para o endereço IP de ferramentas do console a ser adicionado.

*dwFlags*\
Tipo: XTF\_ADD\_CONSOLE\_FLAGS

Uma combinação de sinalizadores OR bit a bit que especificam como adicionar o console à instância. A tabela a seguir descreve os sinalizadores disponíveis.

| Valor | Macro | Descrição |
| - | - | - |
| 0x0 | XTF\_ADD\_CONSOLE\_FLAGS\_NONE | Nenhum sinalizador é especificado. |
| 0x1 | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | Depois que o console de desenvolvimento for adicionado, defina-o como o console de desenvolvimento padrão deste PC. |

### 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 adiciona o console de desenvolvimento especificado em `pszAddress`, usando o nome especificado em `pszAlias`, à instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md). Se `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` for especificado em `dwFlags`, o console de desenvolvimento também será definido como o console de desenvolvimento padrão deste PC. Para obter mais informações sobre o console de desenvolvimento padrão, consulte [Método IXtfConsoleManager::SetDefaultConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md).

Depois que esse método for chamado com êxito, a instância de `IXtfConsoleManager` invocará o método de retorno de chamada [OnAddConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.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). Se `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` for especificado em `dwFlags`, 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` também será invocado.

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

[Método IXtfConsoleManager::GetConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[Método IXtfConsoleManager::RemoveConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[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

- [OnAddConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.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)
- [add_local_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
- [add_remote_user](https://docs.xbox.com/pt-BR/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)