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

# GetConfigSettings

> IXtfConsoleControlClient::GetConfigSettings

# IXtfConsoleControlClient::GetConfigSettings

Faz com que todas as definições de configuração sejam enumeradas, invocando um retorno de chamada para cada definição de configuração.

## Sintaxe

```cpp theme={null}
HRESULT GetConfigSettings(
         IXtfConfigSettingsCallback *pCallback
)  
```

### Parâmetros

*pCallback*\
Tipo: [IXtfConfigSettingsCallback](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)\*

Um ponteiro para uma instância da interface [IXtfConfigSettingsCallback](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md), a ser invocada à medida que cada definição de configuração é enumerada.

### Valor retornado

Tipo: HRESULT

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

## Comentários

Essa função faz com que a API do XBOX Tools Framework (XTF) enumere todas as definições de configuração do console de desenvolvimento atual. Quando uma definição de configuração é encontrada, a API do XTF invoca a função de retorno de chamada [OnFoundSetting](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md) da interface [IXtfConfigSettingsCallback](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md) implementada no seu aplicativo e especificada em `pCallback`. A API do XTF passa um ponteiro para uma estrutura [XTFCONFIGSETTING](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md), que descreve a definição de configuração, quando invoca a função `OnFoundSetting` implementada por você.

> [!NOTE]
>
> A memória da estrutura [XTFCONFIGSETTING](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md) pertence à API do XBOX Tools Framework (XTF) e é invalidada após cada invocação da sua função de retorno de chamada [IXtfConfigSettingsCallback::OnFoundSetting](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md). Você deve copiar as informações da estrutura se precisar delas para uso posterior.

Você também pode usar o método [IXtfConsoleControlClient::GetAllSettings](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md) para retornar uma matriz de estruturas `XTFCONFIGSETTING` para todas as definições de configuração do console de desenvolvimento atual.

Para obter mais informações sobre como acessar definições de configuração usando o XBOX Tools Framework (XTF), confira [Configuração (xbconfig.exe) (tópico NDA)](https://devdocs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md).

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

[IXtfConfigSettingsCallback::OnFoundSetting](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)\
[IXtfConsoleControlClient::GetAllSettings](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)\
[IXtfConsoleControlClient](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [GetAllSettings](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConfigSettingsCallback (conteúdo da interface)](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)
- [OnFoundSetting](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [GetConfigValue](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)
- [XTFCONFIGSETTING](https://devdocs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md)