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

# OnConsoleFound

> IXtfEnumerateConsolesCallback::OnConsoleFound Method

# IXtfEnumerateConsolesCallback::OnConsoleFound Method

在 [IXtfConsoleManager::EnumerateConsoles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) 操作期间发现开发主机时调用。

## 语法

```cpp theme={null}
public:
HRESULT OnConsoleFound(
         const XTFCONSOLEDATA *pConsoleData
)  
```

### 参数

*pConsoleData*\
类型：XTFCONSOLEDATA\*

接收 [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) 实例的 [EnumerateConsoles](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) 方法期间，对于该实例中找到的每个开发主机，该实例都会调用此回调方法。此方法提供有关找到的开发主机的信息，包括名称和工具 IP 地址。

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

## 要求

**头文件：** xtfconsolemanager.h

**库：** xtfconsolemanager.lib

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

## 另请参阅

[IXtfConsoleManager::GetConsole Method](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[IXtfConsoleManager::GetDefaultConsole Method](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[IXtfEnumerateConsolesCallback Interface](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/ixtfenumerateconsolescallback-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)
- [IXtfEnumerateConsolesCallback 接口（接口内容）](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/ixtfenumerateconsolescallback-xtfconsolemanager-xbox-microsoft-t.md)
- [OnFoundProcess](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [OnFoundSetting](https://docs.xbox.com/zh-CN/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [match_found](https://docs.xbox.com/zh-CN/services/playfab/api-references/events/Matchmaking/match-found.md)