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

# GetConsole

> IXtfConsoleManager::GetConsole Method

# IXtfConsoleManager::GetConsole Method

从 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 实例中获取具有指定名称的开发主机的相关信息。

## 语法

```cpp theme={null}
public:
HRESULT GetConsole(
         LPCWSTR pszAlias,
         PXTFCONSOLEDATA pConsoleData
)  
```

### 参数

*pszAlias*\
类型：LPCWSTR

指向要获取信息的主机名称的指针。

*pConsoleData*\
类型：PXTFCONSOLEDATA

接收 [XTFCONSOLEDATA](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) 结构的指针，该结构包含有关开发主机的信息。

### 返回值

类型：HRESULT

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

## 备注

此方法从 [IXtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 实例获取名称由 `pszAlias` 指定的开发主机的信息。这些信息以 [XTFCONSOLEDATA](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) 结构的形式在 `pConsoleData` 中返回，其中包含指定主机的名称和工具 IP 地址。

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

## 要求

**头文件：** xtfconsolemanager.h

**库：** xtfconsolemanager.lib

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

## 另请参阅

[IXtfConsoleManager::EnumerateConsoles 方法](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[IXtfConsoleManager Interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)\
[XtfConsoleManager](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)


## Related topics

- [EnumerateConsoles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [OnConsoleFound](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [AddConsole](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfConsoleManager 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XTFCONSOLEDATA](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md)