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

# IXtfEnumerateConsolesCallback::OnConsoleFound 方法

在 [IXtfConsoleManager::EnumerateConsoles](https://docs.xbox.com/zh-TW/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-TW/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) 結構的指標，該結構包含所找到之開發主機的相關資訊。

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

## 備註

在 [IXtfConsoleManager](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) 執行個體叫用其 [EnumerateConsoles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) 方法期間，該執行個體每找到一部開發主機，就會叫用此回呼方法。此方法會提供所找到之開發主機的相關資訊，包括名稱和工具 IP 位址。

如需連線和查詢開發主機的詳細資訊，請參閱[連線 (xbconnect.exe) (NDA 主題)](https://docs.xbox.com/zh-TW/tools/tools-console/commandlinetools/xbconnect.md)。

## 需求

**標頭：** xtfconsolemanager.h

**程式庫：** xtfconsolemanager.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

## 另請參閱

[IXtfConsoleManager::GetConsole 方法](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[IXtfConsoleManager::GetDefaultConsole 方法](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)\
[IXtfEnumerateConsolesCallback 介面](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/ixtfenumerateconsolescallback-xtfconsolemanager-xbox-microsoft-t.md)\
[XtfConsoleManager](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)


## Related topics

- [EnumerateConsoles](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfEnumerateConsolesCallback 介面 (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/ixtfenumerateconsolescallback-xtfconsolemanager-xbox-microsoft-t.md)
- [OnFoundSetting](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [OnFoundProcess](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfRunningProcessCallback/methods/ixtfrunningprocesscallback_onfoundprocess.md)
- [match_found](https://docs.xbox.com/zh-TW/services/playfab/api-references/events/Matchmaking/match-found.md)