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

# XPackageGetUserLocale

> XPackageGetUserLocale

# XPackageGetUserLocale

Obtient les paramètres régionaux actuels de l'utilisateur.

<a id="syntaxSection" />

## Syntaxe

```cpp theme={null}
HRESULT XPackageGetUserLocale(
    size_t localeSize,
    char* locale
)  
```

<a id="parametersSection" />

### Paramètres

*localeSize*   \_In\_\
Type : size\_t

En cas de réussite, taille de la chaîne dans *locale*.

*locale*   \_Out\_writes\_(localeSize)\
Type : char\*

En cas de réussite, contient les paramètres régionaux de l'utilisateur.

<a id="retvalSection" />

### Valeur renvoyée

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

<a id="remarksSection" />

## Remarques

<Note>Cette fonction ne peut pas être appelée en toute sécurité sur un thread à contrainte de temps. Pour plus d'informations, consultez [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads).</Note>

Cette fonction obtient les paramètres régionaux de l'utilisateur qui correspondent le mieux aux paramètres régionaux du package. Si aucune information de paramètres régionaux n'est déclarée pour le package, cette fonction réussit, mais ne renvoie pas de paramètres régionaux utilisateur dans `locale`. Si les paramètres régionaux du package correspondent à des paramètres régionaux utilisateur installés, la fonction réussit et renvoie les paramètres régionaux utilisateur dans `locale`. Si les paramètres régionaux du package ne correspondent pas exactement à des paramètres régionaux utilisateur installés, la fonction tente de trouver les paramètres régionaux utilisateur installés les plus proches. Si la fonction ne trouve pas de correspondance proche, une erreur se produit ; sinon, la fonction réussit et les paramètres régionaux utilisateur installés les plus proches sont renvoyés dans `locale`.

Si vous utilisez Intelligent Delivery pour contrôler les langues installées pour votre jeu, il est possible que les paramètres régionaux définis par l'utilisateur sur la console comportent des blocs qui ne sont pas actuellement installés. Un jeu doit alors toujours vérifier que les blocs nécessaires sont installés et, si ce n'est pas le cas, se rabattre sur une autre langue : une procédure qui exige une connaissance approfondie des paramètres régionaux et de la manière dont ils se rabattent sur les langues les plus proches. Cette fonction permet d'obtenir les paramètres régionaux actuels de l'utilisateur, ou la solution de repli la plus proche, sans avoir à implémenter votre propre procédure d'analyse et de repli des paramètres régionaux.

L'exemple de code suivant montre comment utiliser cette fonction.

```cpp theme={null}
char gameLocale[LOCALE_NAME_MAX_LENGTH];

// Get the best user locale that is installed
HRESULT hr = XPackageGetUserLocale(_countof(gameLocale), gameLocale);
if (SUCCEEDED(hr))
{
    printf("Game using locale: %s\n", gameLocale);
}
```

<a id="requirementsSection" />

## Configuration requise

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

**Bibliothèque :** xgameruntime.lib

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

<a id="seealsoSection" />

## Documentation conceptuelle

* [Intelligent Delivery : spécificateurs de langue](/fr/build/core-features/common/packaging/intelligentdelivery-language)
* [Threads à contrainte de temps](https://learn.microsoft.com/gaming/gdk/docs/gdk-dev/console-dev/overviews/threads/time-sensitive-threads)
* [Déterminer les paramètres régionaux et la langue de la console](/fr/build/game-principles/localization/determining-console-locale)

## Voir aussi

[XPackage](/fr/reference/system/xpackage/xpackage_members)\
[Installation en streaming et Intelligent Delivery](/fr/build/core-features/common/packaging/overviews/streaming_install-intelligent_delivery)


## Related topics

- [XPackageGetUserLocale](/reference/system/xpackage/functions/xpackagegetuserlocale.md)
- [Determining console locale and language](/build/game-principles/localization/determining-console-locale.md)
- [Localization and globalization overview](/build/game-principles/localization.md)
- [Determinación de la configuración regional y el idioma de la consola](/es/build/game-principles/localization/determining-console-locale.md)
- [确定主机区域设置与语言](/zh-CN/build/game-principles/localization/determining-console-locale.md)