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

Gets information about a development console with the specified name from the [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) instance.

## Syntax

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

### Parameters

*pszAlias*\
Type: LPCWSTR

A pointer to the name of the console to get information about.

*pConsoleData*\
Type: PXTFCONSOLEDATA

A pointer that receives an [XTFCONSOLEDATA](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) structure, which contains information about the development console.

### Return value

Type: HRESULT

Returns `S_OK` if successful; otherwise, returns an HRESULT error code.

## Remarks

This method gets information about the development console with the name specified in `pszAlias` from the [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) instance. The information is returned in `pConsoleData` as an [XTFCONSOLEDATA](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md) structure containing the name and Tools IP address of the specified console.

For more information about connecting and querying development consoles, see [Connect (xbconnect.exe) (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbconnect.md).

## Requirements

**Header:** xtfconsolemanager.h

**Library:** xtfconsolemanager.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

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


## Related topics

- [EnumerateConsoles](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [OnConsoleFound](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [AddConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [IXtfConsoleManager Interface (Interface contents)](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)
- [XTFCONSOLEDATA](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t.md)