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

> IXtfConsoleControlClient::GetConfigSettings

# IXtfConsoleControlClient::GetConfigSettings

모든 구성 설정을 열거하고 각 구성 설정에 대해 콜백을 호출합니다.

<a id="syntaxSection" />

## 구문

```cpp theme={null}
HRESULT GetConfigSettings(
         IXtfConfigSettingsCallback *pCallback
)  
```

<a id="parametersSection" />

### 매개 변수

*pCallback*\
형식: [IXtfConfigSettingsCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback)\*

각 구성 설정이 열거될 때 호출할 [IXtfConfigSettingsCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback) 인터페이스 인스턴스에 대한 포인터입니다.

<a id="retvalSection" />

### 반환 값

형식: HRESULT

성공하면 `S_OK`를 반환하고, 그렇지 않으면 HRESULT 오류 코드를 반환합니다.

<a id="remarksSection" />

## 설명

이 함수는 XBOX Tools Framework(XTF) API가 현재 개발 콘솔의 모든 구성 설정을 열거하도록 합니다. 구성 설정이 발견되면 XTF API는 `pCallback`에 지정된 앱에 구현된 [IXtfConfigSettingsCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback) 인터페이스의 [OnFoundSetting](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 콜백 함수를 호출합니다. XTF API는 구현된 `OnFoundSetting` 함수를 호출할 때 구성 설정을 설명하는 [XTFCONFIGSETTING](/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting) 구조체에 대한 포인터를 전달합니다.

<Note>[XTFCONFIGSETTING](/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting) 구조체의 메모리는 XBOX Tools Framework(XTF) API가 소유하며 [IXtfConfigSettingsCallback::OnFoundSetting](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) 콜백 함수가 호출될 때마다 무효화됩니다. 나중에 사용해야 하는 경우 구조체의 정보를 복사해야 합니다.</Note>

또한 [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="requirementsSection" />

## 요구 사항

**헤더:** xtfconsolecontrol.h

**라이브러리:** xtfconsolecontrol.lib

**지원 플랫폼:** Windows(XBOX 콘솔 도구용)

<a id="seealsoSection" />

## 함께 보기

[IXtfConfigSettingsCallback::OnFoundSetting](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting)\
[IXtfConsoleControlClient::GetAllSettings](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings)\
[IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfConsoleControlClient::GetAllSettings](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetConfigValue](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)
- [IXtfConfigSettingsCallback::OnFoundSetting](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [XTFCONFIGSETTING](/ko/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md)
- [IXtfConsoleControlClient](/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
