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

# IXtfConsoleControlClient::GetConfigValue

> IXtfConsoleControlClient::GetConfigValue

# IXtfConsoleControlClient::GetConfigValue

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

<a id="syntaxSection" />

## Sintaxe

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

<a id="parametersSection" />

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

<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

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

<a id="remarks_output" />

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

<a id="requirementsSection" />

## Requisitos

**Cabeçalho:** xtfconsolecontrol.h

**Biblioteca:** xtfconsolecontrol.lib

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

<a id="seealsoSection" />

## Confira também

[IXtfConsoleControlClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/pt-BR/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfConsoleControlClient::SetConfigValue](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GetConfigSettings](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md)
- [IXtfConsoleControlClient::GetAllSettings](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetRunningProcesses](/pt-BR/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)