> ## 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/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md) 関数を使用して構成設定を反復処理し、構成設定ごとにアプリで実装した [IXtfConfigSettingsCallback::OnFoundSetting](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md) コールバック関数を呼び出すことができます。また、[IXtfConsoleControlClient::GetAllSettings](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md) メソッドを使用して、現在の開発コンソール上のすべての構成設定について `XTFCONFIGSETTING` 構造体の配列を返すこともできます。

XBOX Tools Framework (XTF) を使用した構成設定へのアクセスの詳細については、[Configuration (xbconfig.exe) (NDA topic)](https://docs.xbox.com/ja-jp/tools/tools-console/commandlinetools/xbconfig.md) を参照してください。

### LPBSTR ポインターの取り扱い

この関数が返す LPBSTR ポインターの取り扱いについては、[Allocating and Releasing Memory for a 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/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [SetConfigValue](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient (インターフェイスの内容)](https://docs.xbox.com/ja-jp/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [PartyAudioManipulationSinkStream::GetConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSinkStream/methods/partyaudiomanipulationsinkstream_getconfiguration.md)
- [PartyAudioManipulationSourceStream::GetConfiguration](https://docs.xbox.com/ja-jp/services/playfab/multiplayer/networking/reference/classes/PartyAudioManipulationSourceStream/methods/partyaudiomanipulationsourcestream_getconfiguration.md)
- [GetPMCValue](https://docs.xbox.com/ja-jp/reference/tools/pix3/functions/getpmcvalue.md)