> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Estrutura XTFCONSOLEDATA

> Estrutura XTFCONSOLEDATA

# Estrutura XTFCONSOLEDATA

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="membersSection" />

### Membros

*bstrAlias*\
O nome do console.

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

<a id="remarksSection" />

## 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](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t).

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](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t). Da mesma forma, a interface [IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t) usa essa estrutura nos métodos [GetConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m) e [GetDefaultConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m) 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)](/pt-BR/tools/tools-console/commandlinetools/xbconnect).

<a id="remarks_output" />

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfconsolemanager.h

**Biblioteca:** xtfconsolemanager.lib

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

<a id="seealsoSection" />

## Confira também

[Interface IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t)\
[XtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/xtfconsolemanager-xbox-microsoft-n)


## Related topics

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