> ## 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éthode IXtfConsoleManager::AddConsole

# Méthode IXtfConsoleManager::AddConsole

Ajoute une console de développement à l'instance [IXtfConsoleManager](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md).

## Syntaxe

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

### Paramètres

*pszAlias*\
Type : LPCWSTR

Pointeur vers le nom de la console à ajouter.

*pszAddress*\
Type : LPCWSTR

Pointeur vers l'adresse IP des outils (Tools IP) de la console à ajouter.

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

Combinaison d'indicateurs à l'aide d'un OR au niveau du bit qui spécifie comment ajouter la console à l'instance. Le tableau suivant décrit les indicateurs disponibles.

| Valeur | Macro | Description |
| - | - | - |
| 0x0 | XTF\_ADD\_CONSOLE\_FLAGS\_NONE | Aucun indicateur n'est spécifié. |
| 0x1 | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | Une fois la console de développement ajoutée, la définir comme console de développement par défaut pour ce PC. |

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

## Remarques

Cette méthode ajoute la console de développement spécifiée dans `pszAddress`, en utilisant le nom spécifié dans `pszAlias`, à l'instance [IXtfConsoleManager](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md). Si `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` est spécifié dans `dwFlags`, la console de développement est également définie comme console de développement par défaut pour ce PC. Pour plus d'informations sur la console de développement par défaut, consultez [Méthode IXtfConsoleManager::SetDefaultConsole](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md).

Une fois cette méthode appelée avec succès, l'instance `IXtfConsoleManager` appelle la méthode de rappel [OnAddConsole](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md) de l'instance [IXtfConsoleManagerCallback](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md) associée. Si `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` est spécifié dans `dwFlags`, la méthode de rappel [OnChangedDefaultConsole](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md) de l'instance `IXtfConsoleManagerCallback` associée est également appelée.

Pour plus d'informations sur la connexion aux consoles de développement et leur interrogation, consultez [Connexion (xbconnect.exe) (rubrique NDA)](https://docs.xbox.com/fr-CA/tools/tools-console/commandlinetools/xbconnect.md).

## Configuration requise

**En-tête :** xtfconsolemanager.h

**Bibliothèque :** xtfconsolemanager.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

## Voir aussi

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


## Related topics

- [OnAddConsole](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [Interface IXtfConsoleManager (contenu de l'interface)](https://docs.xbox.com/fr-CA/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [add_local_user](https://docs.xbox.com/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_local_user.md)
- [add_remote_user](https://docs.xbox.com/fr-CA/reference/chat/gamechat2/classes/chat_manager/methods/chat_manager_add_remote_user.md)