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

# XTFCONSOLEDATA

> XTFCONSOLEDATA Structure

Contains information about a development console in an [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) instance.

## Syntax

```cpp theme={null}
typedef struct _XTFCONSOLEDATA {
    BSTR bstrAlias;
    BSTR bstrAddress;
} XTFCONSOLEDATA, *PXTFCONSOLEDATA;  
```

### Members

*bstrAlias*\
The name of the console.

*bstrAddress*\
The Tools IP address of the console.

## Remarks

This structure contains information, including the alias and IP address, for a development console in an [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) instance.

The **IXtfConsoleManagerCallback** and **IXtfEnumerateConsolesCallback** interfaces use the `XTFCONSOLEDATA` structure to pass information about development consoles when any of their callback methods are invoked by an [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) instance. Similarly, the [IXtfConsoleManager](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) interface uses this structure in the [GetConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) and [GetDefaultConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) methods to provide information about a development console.

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

### Handling BSTR pointers

For more information about handling BSTR pointers returned in this structure, see [Allocating and Releasing Memory for a BSTR](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019).

## Requirements

**Header:** xtfconsolemanager.h

**Library:** xtfconsolemanager.lib

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

## See also

[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

- [OnAddConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onaddconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microsoft.md)
- [OnRemoveConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onremoveconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox-microso.md)
- [OnConsoleFound](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [OnChangedDefaultConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManagerCallback/methods/onchangeddefaultconsole-ixtfconsolemanagercallback-xtfconsolemanager-xbox.md)
- [GetDefaultConsole](https://docs.xbox.com/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)