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

取得指定組態設定的值。

## 語法

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

### 參數

*pszKey*\
類型：LPCWSTR

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

*pszValue*\
類型：LPBSTR

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

### 傳回值

類型：HRESULT

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

## 備註

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

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

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

### 處理 LPBSTR 指標

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

## 需求

**標頭：** xtfconsolecontrol.h

**程式庫：** xtfconsolecontrol.lib

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

## 另請參閱

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


## Related topics

- [SetConfigValue](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient (介面內容)](https://docs.xbox.com/zh-TW/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [GetPMCValue](https://docs.xbox.com/zh-TW/reference/tools/pix3/functions/getpmcvalue.md)
- [ConfigureNBPMCs](https://docs.xbox.com/zh-TW/reference/tools/pix3/functions/configurenbpmcs.md)
- [ConfigurePMCs](https://docs.xbox.com/zh-TW/reference/tools/pix3/functions/configurepmcs.md)