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

# Método IXtfConsoleManager::GetConsole

> Método IXtfConsoleManager::GetConsole

# Método IXtfConsoleManager::GetConsole

Obtém informações sobre um console de desenvolvimento com o nome especificado da instância de [IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t).

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

### Parâmetros

*pszAlias*\
Tipo: LPCWSTR

Um ponteiro para o nome do console sobre o qual obter informações.

*pConsoleData*\
Tipo: PXTFCONSOLEDATA

Um ponteiro que recebe uma estrutura [XTFCONSOLEDATA](/pt-BR/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t), que contém informações sobre o console de desenvolvimento.

<a id="retvalSection" />

### Valor retornado

Tipo: HRESULT

Retorna `S_OK` se for bem-sucedido; caso contrário, retorna um código de erro HRESULT.

<a id="remarksSection" />

## Comentários

Esse método obtém informações sobre o console de desenvolvimento com o nome especificado em `pszAlias` da instância de [IXtfConsoleManager](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-t). As informações são retornadas em `pConsoleData` como uma estrutura [XTFCONSOLEDATA](/pt-BR/reference/tools/xtf/xtfconsolemanager/structures/xtfconsoledata-xtfconsolemanager-xbox-microsoft-t) que contém o nome e o endereço IP de ferramentas do console especificado.

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

<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

[Método IXtfConsoleManager::EnumerateConsoles](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-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 IXtfConsoleManager::EnumerateConsoles](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/enumerateconsoles-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfConsoleManager::AddConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/addconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfEnumerateConsolesCallback::OnConsoleFound](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfEnumerateConsolesCallback/methods/onconsolefound-ixtfenumerateconsolescallback-xtfconsolemanager-xbox-mi.md)
- [Método IXtfConsoleManager::GetDefaultConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/getdefaultconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)
- [Método IXtfConsoleManager::RemoveConsole](/pt-BR/reference/tools/xtf/xtfconsolemanager/classes/IXtfConsoleManager/methods/removeconsole-ixtfconsolemanager-xtfconsolemanager-xbox-microsoft-m.md)