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

> IXtfConsoleManager::AddConsole method

# IXtfConsoleManager::AddConsole method

開発コンソールを [IXtfConsoleManager](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) インスタンスに追加します。

## 構文

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

### パラメーター

*pszAlias*\
型: LPCWSTR

追加するコンソールの名前へのポインターです。

*pszAddress*\
型: LPCWSTR

追加するコンソールの Tools IP アドレスへのポインターです。

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

コンソールをインスタンスに追加する方法を指定するフラグのビット単位の OR の組み合わせです。使用可能なフラグを次の表に示します。

| 値 | マクロ | 説明 |
| - | - | - |
| 0x0 | XTF\_ADD\_CONSOLE\_FLAGS\_NONE | フラグは指定されません。 |
| 0x1 | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | 開発コンソールが追加された後、その PC の既定の開発コンソールとして設定します。 |

### 戻り値

型: HRESULT

成功した場合は `S_OK` を返します。それ以外の場合は HRESULT エラー コードを返します。

## 解説

このメソッドは、`pszAddress` で指定した開発コンソールを、`pszAlias` で指定した名前を使用して、[IXtfConsoleManager](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) インスタンスに追加します。`dwFlags` に `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` を指定した場合、その開発コンソールは、その PC の既定の開発コンソールとしても設定されます。既定の開発コンソールの詳細については、[IXtfConsoleManager::SetDefaultConsole Method](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) を参照してください。

このメソッドが正常に呼び出されると、`IXtfConsoleManager` インスタンスは、関連付けられた [IXtfConsoleManagerCallback](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t.md) インスタンスから [OnAddConsole](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md) コールバック メソッドを呼び出します。`dwFlags` に `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT` が指定されている場合は、関連付けられた `IXtfConsoleManagerCallback` インスタンスの [OnChangedDefaultConsole](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md) コールバック メソッドも呼び出されます。

開発コンソールへの接続とクエリの詳細については、[Connect (xbconnect.exe) (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbconnect.md) を参照してください。

## 要件

**ヘッダー:** xtfconsolemanager.h

**ライブラリ:** xtfconsolemanager.lib

**サポートされるプラットフォーム:** Windows (XBOX コンソール ツール用)

## 関連項目

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


## Related topics

- [OnAddConsole](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [IXtfConsoleManager インターフェイス (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XtfGetSavedConsoleAddress](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfapi/functions/xtfgetsavedconsoleaddress-xtfapi-xbox-windows-m.md)
- [XtfGetDefaultAddress](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolemanager/methods/xtfgetdefaultaddress-xtfconsolemanager-xbox-windows-m.md)