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

# IXtfConsoleManager::AddConsole method

> IXtfConsoleManager::AddConsole method

# IXtfConsoleManager::AddConsole method

将开发主机添加到 [IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t) 实例中。

<a id="syntaxSection" />

## 语法

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

<a id="parametersSection" />

### 参数

*pszAlias*\
类型：LPCWSTR

指向要添加的主机名称的指针。

*pszAddress*\
类型：LPCWSTR

指向要添加的主机的工具 IP 地址的指针。

*dwFlags*\
类型：XTF\_ADD\_CONSOLE\_FLAGS

按位或标志的组合，用于指定如何将主机添加到实例中。下表描述了可用的标志。

| 值   | 宏                                    | 说明                         |
| --- | ------------------------------------ | -------------------------- |
| 0x0 | XTF\_ADD\_CONSOLE\_FLAGS\_NONE       | 未指定任何标志。                   |
| 0x1 | XTF\_ADD\_CONSOLE\_FLAGS\_SETDEFAULT | 添加开发主机后，将其设置为此 PC 的默认开发主机。 |

<a id="retvalSection" />

### 返回值

类型：HRESULT

如果成功，则返回 `S_OK`；否则返回 HRESULT 错误代码。

<a id="remarksSection" />

## 备注

此方法使用 `pszAlias` 中指定的名称，将 `pszAddress` 中指定的开发主机添加到 [IXtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t) 实例中。如果 `dwFlags` 中指定了 `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT`，则该开发主机还会被设置为此 PC 的默认开发主机。有关默认开发主机的详细信息，请参阅 [IXtfConsoleManager::SetDefaultConsole 方法](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/setdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)。

成功调用此方法后，`IXtfConsoleManager` 实例会从关联的 [IXtfConsoleManagerCallback](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft-t) 实例调用 [OnAddConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft) 回调方法。如果 `dwFlags` 中指定了 `XTF_ADD_CONSOLE_FLAGS_SETDEFAULT`，还会调用关联的 `IXtfConsoleManagerCallback` 实例中的 [OnChangedDefaultConsole](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox) 回调方法。

有关连接和查询开发主机的详细信息，请参阅 [Connect (xbconnect.exe) (NDA 主题)](/tools/tools-console/commandlinetools/xbconnect)。

<a id="requirementsSection" />

## 要求

**头文件：** xtfconsolemanager.h

**库：** xtfconsolemanager.lib

**支持的平台：** Windows（适用于 XBOX 主机工具）

<a id="seealsoSection" />

## 另请参阅

[IXtfConsoleManager::GetConsole 方法](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[IXtfConsoleManager::RemoveConsole 方法](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m)\
[IXtfConsoleManager Interface](/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t)\
[XtfConsoleManager](/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n)


## Related topics

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