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

# GetConfigValue

> IXtfConsoleControlClient::GetConfigValue

# IXtfConsoleControlClient::GetConfigValue

Obtém o valor da definição de configuração especificada.

## Sintaxe

```cpp theme={null}
HRESULT GetConfigValue(
         LPCWSTR pszKey,
         LPBSTR pszValue
)  
```

### Parâmetros

*pszKey*\
Tipo: LPCWSTR

Um ponteiro para o nome da definição de configuração cujo valor deve ser obtido.

*pszValue*\
Tipo: LPBSTR

O ponteiro que recebe o valor da definição de configuração especificada em *pszKey*.

### 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 retorna o valor de uma única definição de configuração do console de desenvolvimento atual. Se `pszKey` for definido como o ponteiro de uma cadeia de caracteres que contém um nome (ou chave) válido de uma definição de configuração, a função retornará `S_OK` e definirá `pszValue` como o ponteiro de uma cadeia de caracteres que contém o valor dessa definição de configuração. Caso contrário, a função retornará um erro.

Se você quiser enumerar cada definição de configuração do console atual, poderá usar a função [IXtfConsoleControlClient::GetConfigSettings](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md) para iterar sobre as definições de configuração e invocar uma função de retorno de chamada [IXtfConfigSettingsCallback::OnFoundSetting](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md), implementada no seu aplicativo, para cada definição de configuração. Você também pode usar o método [IXtfConsoleControlClient::GetAllSettings](https://docs.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://docs.xbox.com/pt-BR/tools/tools-console/commandlinetools/xbconfig.md).

### Manipulando ponteiros LPBSTR

Para obter mais informações sobre como manipular os ponteiros LPBSTR retornados por essa função, confira [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:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

## Confira também

[IXtfConsoleControlClient](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [SetConfigValue](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient (conteúdo da interface)](https://docs.xbox.com/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [GetPMCValue](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/getpmcvalue.md)
- [ConfigureL2IPMCs](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/configurel2ipmcs.md)
- [ConfigureNBPMCs](https://docs.xbox.com/pt-BR/reference/tools/pix3/functions/configurenbpmcs.md)