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

Causes all configuration settings to be enumerated, invoking a callback for each configuration setting.

## Syntax

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

### Parameters

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

A pointer to an instance of the [IXtfConfigSettingsCallback](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md) interface, to be invoked as each configuration setting is enumerated.

### Return value

Type: HRESULT

Returns `S_OK` if successful; otherwise, returns an HRESULT error code.

## Remarks

This function causes the XBOX Tools Framework (XTF) API to enumerate all of the configuration settings on the current development console. When a configuration setting is found, the XTF API invokes the [OnFoundSetting](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md) callback function from the [IXtfConfigSettingsCallback](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md) interface implemented in your app and specified in `pCallback`. The XTF API passes a pointer to an [XTFCONFIGSETTING](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md) structure, describing the configuration setting, when it invokes your implemented `OnFoundSetting` function.

> [!NOTE]
>
> Memory for the [XTFCONFIGSETTING](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md) structure is owned by the XBOX Tools Framework (XTF) API and is invalidated after each invocation of your [IXtfConfigSettingsCallback::OnFoundSetting](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md) callback function. You must copy the information in the structure if you need it for later use.

You can also use the [IXtfConsoleControlClient::GetAllSettings](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md) method to return an array of `XTFCONFIGSETTING` structures for all configuration settings on the current development console.

For more information about accessing configuration settings using XBOX Tools Framework (XTF), see [Configuration (xbconfig.exe) (NDA topic)](https://docs.xbox.com/tools/tools-console/commandlinetools/xbconfig.md).

## Requirements

**Header:** xtfconsolecontrol.h

**Library:** xtfconsolecontrol.lib

**Supported platforms:** Windows (for XBOX console tools)

## See also

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


## Related topics

- [GetAllSettings](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConfigSettingsCallback (Interface contents)](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback.md)
- [OnFoundSetting](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [GetConfigValue](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)
- [XtfConsoleControl (API contents)](https://docs.xbox.com/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members.md)