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

取得指定組態設定的值。

<a id="syntaxSection" />

## 語法

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

<a id="parametersSection" />

### 參數

*pszKey*\
類型：LPCWSTR

指向要取得其值之組態設定名稱的指標。

*pszValue*\
類型：LPBSTR

接收 *pszKey* 中所指定組態設定之值的指標。

<a id="retvalSection" />

### 傳回值

類型：HRESULT

如果成功，則傳回 `S_OK`；否則傳回 HRESULT 錯誤碼。

<a id="remarksSection" />

## 備註

此函式會從目前的開發主機傳回單一組態設定的值。如果 `pszKey` 設定為指向包含有效組態設定名稱 (或索引鍵) 之字串的指標，函式會傳回 `S_OK`，並將 `pszValue` 設定為指向包含該組態設定值之字串的指標。否則，函式會傳回錯誤。

如果您想要列舉目前主機上的每個組態設定，可以使用 [IXtfConsoleControlClient::GetConfigSettings](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings) 函式逐一查看組態設定，並針對每個組態設定叫用您應用程式中實作的 [IXtfConfigSettingsCallback::OnFoundSetting](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 回呼函式。您也可以使用 [IXtfConsoleControlClient::GetAllSettings](/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings) 方法，傳回目前開發主機上所有組態設定的 `XTFCONFIGSETTING` 結構陣列。

如需使用 XBOX Tools Framework (XTF) 存取組態設定的詳細資訊，請參閱[組態 (xbconfig.exe) (NDA 主題)](/zh-TW/tools/tools-console/commandlinetools/xbconfig)。

<a id="remarks_output" />

### 處理 LPBSTR 指標

如需處理此函式所傳回之 LPBSTR 指標的詳細資訊，請參閱[為 BSTR 配置及釋放記憶體](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019)。

<a id="requirementsSection" />

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

**支援的平台：** Windows (適用於 XBOX 主機工具)

<a id="seealsoSection" />

## 另請參閱

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


## Related topics

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