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

> Estrutura XTFCONSOLEDATA

# Estrutura XTFCONSOLEDATA

Contém informações sobre um console de desenvolvimento em uma instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md).

## Sintaxe

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

### Membros

*bstrAlias*\
O nome do console.

*bstrAddress*\
O endereço IP de ferramentas do console.

## Comentários

Essa estrutura contém informações, incluindo o alias e o endereço IP, de um console de desenvolvimento em uma instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md).

As interfaces **IXtfConsoleManagerCallback** e **IXtfEnumerateConsolesCallback** usam a estrutura `XTFCONSOLEDATA` para passar informações sobre consoles de desenvolvimento quando qualquer um de seus métodos de retorno de chamada é invocado por uma instância de [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md). Da mesma forma, a interface [IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md) usa essa estrutura nos métodos [GetConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) e [GetDefaultConsole](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md) para fornecer informações sobre um console de desenvolvimento.

Para obter mais informações sobre como consultar consoles de desenvolvimento, consulte [Conectar (xbconnect.exe) (tópico sob NDA)](https://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconnect.md).

### Como lidar com ponteiros BSTR

Para obter mais informações sobre como lidar com ponteiros BSTR retornados nessa estrutura, consulte [Alocando e liberando memória para um BSTR](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019).

## Requisitos

**Cabeçalho:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

**Plataformas com suporte:** Windows (para ferramentas do console XBOX)

## Confira também

[Interface IXtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t.md)\
[XtfConsoleManager](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n.md)


## Related topics

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