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

Agrega una consola de desarrollo a la instancia de [IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t).

<a id="syntaxSection" />

## Sintaxis

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

<a id="parametersSection" />

### Parámetros

*pszAlias*\
Tipo: LPCWSTR

Un puntero al nombre de la consola que se va a agregar.

*pszAddress*\
Tipo: LPCWSTR

Un puntero a la dirección IP de herramientas de la consola que se va a agregar.

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

Una combinación de marcas OR bit a bit que especifican cómo agregar la consola a la instancia. La tabla siguiente describe las marcas disponibles.

| Valor | Macro                                | Descripción                                                                                                           |
| ----- | ------------------------------------ | --------------------------------------------------------------------------------------------------------------------- |
| 0x0   | XTF\_ADD\_CONSOLE\_FLAGS\_NONE       | No se especifica ninguna marca.                                                                                       |
| 0x1   | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | Después de agregar la consola de desarrollo, la establece como consola de desarrollo predeterminada para este equipo. |

<a id="retvalSection" />

### Valor devuelto

Tipo: HRESULT

Devuelve `S_OK` si se ejecuta correctamente; de lo contrario, devuelve un código de error HRESULT.

<a id="remarksSection" />

## Comentarios

Este método agrega la consola de desarrollo especificada en `pszAddress`, con el nombre especificado en `pszAlias`, a la instancia de [IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t). Si se especifica `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` en `dwFlags`, la consola de desarrollo también se establece como consola de desarrollo predeterminada para este equipo. Para obtener más información sobre la consola de desarrollo predeterminada, consulte [Método IXtfConsoleManager::SetDefaultConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m).

Después de llamar correctamente a este método, la instancia de `IXtfConsoleManager` invoca el método de devolución de llamada [OnAddConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft) de la instancia de [IXtfConsoleManagerCallback](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t) asociada. Si se especifica `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` en `dwFlags`, también se invoca el método de devolución de llamada [OnChangedDefaultConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox) de la instancia de `IXtfConsoleManagerCallback` asociada.

Para obtener más información sobre cómo conectar y consultar consolas de desarrollo, consulte [Conexión (xbconnect.exe) (tema NDA)](/tools/tools-console/commandlinetools/xbconnect).

<a id="requirementsSection" />

## Requisitos

**Encabezado:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

**Plataformas compatibles:** Windows (para herramientas de consola XBOX)

<a id="seealsoSection" />

## Consulte también

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


## Related topics

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