> ## 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](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings) 함수를 사용하여 구성 설정을 반복하고, 각 구성 설정에 대해 앱에 구현된 [IXtfConfigSettingsCallback::OnFoundSetting](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 콜백 함수를 호출할 수 있습니다. 또한 [IXtfConsoleControlClient::GetAllSettings](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings) 메서드를 사용하여 현재 개발 콘솔의 모든 구성 설정에 대한 `XTFCONFIGSETTING` 구조체 배열을 반환할 수도 있습니다.

XBOX Tools Framework(XTF)를 사용하여 구성 설정에 액세스하는 방법에 대한 자세한 내용은 [구성(xbconfig.exe)(NDA 항목)](/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](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

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