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