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

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

<a id="syntaxSection" />

## Syntax

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

<a id="parametersSection" />

### Parameters

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

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

<a id="retvalSection" />

### Return value

Type: HRESULT

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

<a id="remarksSection" />

## 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](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting) callback function from the [IXtfConfigSettingsCallback](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/ixtfconfigsettingscallback) interface implemented in your app and specified in `pCallback`. The XTF API passes a pointer to an [XTFCONFIGSETTING](/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting) structure, describing the configuration setting, when it invokes your implemented `OnFoundSetting` function.

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

You can also use the [IXtfConsoleControlClient::GetAllSettings](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings) 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)](/tools/tools-console/commandlinetools/xbconfig).

<a id="requirementsSection" />

## Requirements

**Header:** xtfconsolecontrol.h

**Library:** xtfconsolecontrol.lib

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

<a id="seealsoSection" />

## See also

[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](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetConfigValue](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigvalue.md)
- [IXtfConfigSettingsCallback::OnFoundSetting](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting.md)
- [XTFCONFIGSETTING](/reference/tools/xtf/xtfconsolecontrol/structs/xtfconfigsetting.md)
- [IXtfConsoleControlClient](/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)