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

Type : HRESULT

Code de réussite ou d'erreur HRESULT.

<a id="remarksSection" />

## Remarques

<Note>Il n'est pas sécuritaire d'appeler cette fonction sur un thread sensible au temps. Pour plus d'informations, consultez [Threads sensibles au 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 retourne pas de paramètres régionaux de l'utilisateur dans `locale`. Si les paramètres régionaux du package correspondent à des paramètres régionaux de l'utilisateur installés, la fonction réussit et retourne les paramètres régionaux de l'utilisateur dans `locale`. Si les paramètres régionaux du package ne correspondent pas exactement à des paramètres régionaux de l'utilisateur installés, la fonction tente de trouver les paramètres régionaux de l'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 de l'utilisateur installés les plus proches sont retourné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. Le jeu doit alors toujours vérifier que les blocs nécessaires sont installés et, s'ils ne le sont pas, se rabattre sur une autre langue : une procédure qui exige une connaissance approfondie des paramètres régionaux et de la façon dont ils se rabattent sur leurs langues les plus proches. Cette fonction permet d'obtenir les paramètres régionaux actuels de l'utilisateur, ou les paramètres de repli les plus proches, 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-CA/build/core-features/common/packaging/intelligentdelivery-language)
* [Threads sensibles au 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-CA/build/game-principles/localization/determining-console-locale)

## Voir aussi

[XPackage](/fr-CA/reference/system/xpackage/xpackage_members)\
[Installation en continu et Intelligent Delivery](/fr-CA/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)