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

# Método IXtfConsoleManager::AddConsole

> Método IXtfConsoleManager::AddConsole

# Método IXtfConsoleManager::AddConsole

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

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

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

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

<a id="remarksSection" />

## Comentários

Esse método adiciona o console de desenvolvimento especificado em `pszAddress`, usando o nome especificado em `pszAlias`, à instância de [IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t). 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](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m).

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

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

<a id="seealsoSection" />

## Confira também

[Método IXtfConsoleManager::GetConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[Método IXtfConsoleManager::RemoveConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[Interface IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t)\
[XtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n)


## Related topics

- [Método IXtfConsoleManagerCallback::OnAddConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [Método IXtfConsoleManagerCallback::OnChangedDefaultConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [Método IXtfConsoleManager::EnumerateConsoles](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfConsoleManager::GetConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfConsoleManager::RemoveConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)