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

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

## Sintaxis

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

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

### Valor devuelto

Tipo: HRESULT

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

## Comentarios

Este método agrega la consola de desarrollo especificada en `pszAddress`, con el nombre especificado en `pszAlias`, a la instancia de [IXtfConsoleManager](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md). 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](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md).

Después de llamar correctamente a este método, la instancia de `IXtfConsoleManager` invoca el método de devolución de llamada [OnAddConsole](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md) de la instancia de [IXtfConsoleManagerCallback](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md) asociada. Si se especifica `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` en `dwFlags`, también se invoca el método de devolución de llamada [OnChangedDefaultConsole](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md) 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)](https://docs.xbox.com/es/tools/tools-console/commandlinetools/xbconnect.md).

## Requisitos

**Encabezado:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

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

## Consulte también

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


## Related topics

- [OnAddConsole](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [Interfaz IXtfConsoleManager (contenido de la interfaz)](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XtfGetSavedConsoleAddress](https://docs.xbox.com/es/reference/tools/xtf/xtfapi/functions/xtfgetsavedconsoleaddress-xtfapi-xbox-windows-m.md)
- [XtfGetDefaultAddress](https://docs.xbox.com/es/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)