Skip to main content

​
XPackageGetUserLocale

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

​
Syntaxe

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

​
Valeur de retour

Type : HRESULT Code de réussite ou d’erreur HRESULT.

​
Remarques

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

​
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

​
Documentation conceptuelle

​
Voir aussi

XPackage
Installation en continu et Intelligent Delivery
Last modified on October 6, 2026