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

# OnFoundSetting

> IXtfConfigSettingsCallback::OnFoundSetting

# IXtfConfigSettingsCallback::OnFoundSetting

Função de retorno de chamada chamada quando uma definição de configuração está sendo relatada.

## Sintaxe

```cpp theme={null}
HRESULT OnFoundSetting(
         const PXTFCONFIGSETTING pSetting
)  
```

### Parâmetros

*pSetting*\
Tipo: PXTFCONFIGSETTING

Um ponteiro para uma estrutura [XTFCONFIGSETTING](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md) que descreve uma definição de configuração.

### 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 de retorno de chamada é invocada por [IXtfConsoleControlClient::GetConfigSettings](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md) para cada definição de configuração encontrada no console de desenvolvimento. Essa função recebe um ponteiro para uma estrutura [XTFCONFIGSETTING](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md) que contém o nome e o valor de uma definição de configuração. 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://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md).

> [!NOTE]
>
> A memória da estrutura [XTFCONFIGSETTING](https://docs.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 dessa função de retorno de chamada. Você deve copiar as informações da estrutura se precisar delas para uso posterior.

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

[IXtfConfigSettingsCallback](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)\
[XtfConsoleControl](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)\
[Referência da API nativa do XBOX Tools Framework](https://docs.xbox.com/pt-BR/reference/tools/xtf/atoc-xtf-native.md)


## Related topics

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