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

> IXtfConsoleControlClient::GetConfigValue

# IXtfConsoleControlClient::GetConfigValue

Obtient la valeur du paramètre de configuration spécifié.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT GetConfigValue(
         LPCWSTR pszKey,
         LPBSTR pszValue
)  
```

<a id="parametersSection" />

### Paramètres

*pszKey*\
Type : LPCWSTR

Pointeur vers le nom du paramètre de configuration dont obtenir la valeur.

*pszValue*\
Type : LPBSTR

Pointeur qui reçoit la valeur du paramètre de configuration spécifié dans *pszKey*.

<a id="retvalSection" />

### Valeur de retour

Type : HRESULT

Retourne `S_OK` en cas de réussite; sinon, retourne un code d'erreur HRESULT.

<a id="remarksSection" />

## Remarques

Cette fonction retourne la valeur d'un seul paramètre de configuration de la console de développement actuelle. Si `pszKey` est défini au pointeur d'une chaîne qui contient un nom (ou une clé) valide de paramètre de configuration, la fonction retourne `S_OK` et définit `pszValue` au pointeur d'une chaîne qui contient la valeur de ce paramètre de configuration. Sinon, la fonction retourne une erreur.

Si vous souhaitez énumérer chaque paramètre de configuration de la console actuelle, vous pouvez utiliser la fonction [IXtfConsoleControlClient::GetConfigSettings](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings) pour parcourir les paramètres de configuration et appeler une fonction de rappel [IXtfConfigSettingsCallback::OnFoundSetting](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConfigSettingsCallback/methods/ixtfconfigsettingscallback_onfoundsetting), implémentée dans votre application, pour chaque paramètre de configuration. Vous pouvez également utiliser la méthode [IXtfConsoleControlClient::GetAllSettings](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings) pour retourner un tableau de structures `XTFCONFIGSETTING` pour tous les paramètres de configuration de la console de développement actuelle.

Pour plus d'informations sur l'accès aux paramètres de configuration à l'aide de XBOX Tools Framework (XTF), consultez [Configuration (xbconfig.exe) (rubrique sous NDA)](/fr-CA/tools/tools-console/commandlinetools/xbconfig).

<a id="remarks_output" />

### Gestion des pointeurs LPBSTR

Pour plus d'informations sur la gestion des pointeurs LPBSTR retournés par cette fonction, consultez [Allocation et libération de mémoire pour un BSTR](https://learn.microsoft.com/cpp/atl-mfc-shared/allocating-and-releasing-memory-for-a-bstr?view=vs-2019).

<a id="requirementsSection" />

## Configuration requise

**En-tête :** xtfconsolecontrol.h

**Bibliothèque :** xtfconsolecontrol.lib

**Plateformes prises en charge :** Windows (pour les outils de console XBOX)

<a id="seealsoSection" />

## Voir aussi

[IXtfConsoleControlClient](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient)\
[XtfConsoleControl](/fr-CA/reference/tools/xtf/xtfconsolecontrol/xtfconsolecontrol_members)


## Related topics

- [IXtfConsoleControlClient::SetConfigValue](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_setconfigvalue.md)
- [IXtfConsoleControlClient](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/ixtfconsolecontrolclient.md)
- [IXtfConsoleControlClient::GetConfigSettings](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getconfigsettings.md)
- [IXtfConsoleControlClient::GetAllSettings](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getallsettings.md)
- [IXtfConsoleControlClient::GetRunningProcesses](/fr-CA/reference/tools/xtf/xtfconsolecontrol/interfaces/IXtfConsoleControlClient/methods/ixtfconsolecontrolclient_getrunningprocesses.md)