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

# GetConfigSettings

> IXtfConsoleControlClient::GetConfigSettings

# IXtfConsoleControlClient::GetConfigSettings

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

## 구문

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

### 매개 변수

*pCallback*\
형식: [IXtfConfigSettingsCallback](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)\*

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

### 반환 값

형식: HRESULT

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

## 설명

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

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

또한 [IXtfConsoleControlClient::GetAllSettings](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md) 메서드를 사용하여 현재 개발 콘솔의 모든 구성 설정에 대한 `XTFCONFIGSETTING` 구조체 배열을 반환할 수도 있습니다.

XBOX Tools Framework(XTF)를 사용하여 구성 설정에 액세스하는 방법에 대한 자세한 내용은 [구성(xbconfig.exe)(NDA 항목)](https://docs.xbox.com/ko/tools/tools-console/commandlinetools/xbconfig.md)을 참조하세요.

## 요구 사항

**헤더:** xtfconsolecontrol.h

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

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

## 함께 보기

[IXtfConfigSettingsCallback::OnFoundSetting](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)\
[IXtfConsoleControlClient::GetAllSettings](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)\
[IXtfConsoleControlClient](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)\
[XtfConsoleControl](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)


## Related topics

- [GetAllSettings](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConfigSettingsCallback (인터페이스 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)
- [OnFoundSetting](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [XtfConsoleControl (API 콘텐츠)](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)
- [GetConfigValue](https://docs.xbox.com/ko/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)