Pular para o conteúdo principal

IXtfConsoleControlClient::GetConfigValue

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

Sintaxe

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 para iterar sobre as definições de configuração e invocar uma função de retorno de chamada IXtfConfigSettingsCallback::OnFoundSetting, implementada no seu aplicativo, para cada definição de configuração. Você também pode usar o método 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).

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.

Requisitos

Cabeçalho: xtfconsolecontrol.h Biblioteca: xtfconsolecontrol.lib Plataformas com suporte: Windows (para ferramentas de console XBOX)

Confira também

IXtfConsoleControlClient
XtfConsoleControl
Última modificação em 6 de outubro de 2026