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 renvoyée
Type : HRESULT Code de réussite ou d’erreur HRESULT.Remarques
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.
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.
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 SeriesDocumentation conceptuelle
- Intelligent Delivery : spécificateurs de langue
- Threads à contrainte de temps
- Déterminer les paramètres régionaux et la langue de la console
Voir aussi
XPackageInstallation en streaming et Intelligent Delivery