Fonction SetProcessPreferredUILanguages (winnls.h)

Article
08/27/2023

Définit les langages d’interface utilisateur préférés du processus pour le processus d’application. Pour plus d’informations, consultez Gestion des langues de l’interface utilisateur.

Syntaxe

BOOL SetProcessPreferredUILanguages(
  [in]            DWORD    dwFlags,
  [in, optional]  PCZZWSTR pwszLanguagesBuffer,
  [out, optional] PULONG   pulNumLanguages
);

Paramètres

[in] dwFlags

Indicateurs identifiant le format de langue à utiliser pour les langues d’interface utilisateur préférées du processus. Les indicateurs s’excluent mutuellement et la valeur par défaut est MUI_LANGUAGE_NAME.

Nous vous recommandons d’utiliser MUI_LANGUAGE_NAME plutôt que MUI_LANGUAGE_ID.

Valeur	Signification
MUI_LANGUAGE_ID	Les chaînes de langue des paramètres d’entrée sont au format identificateur de langue .
MUI_LANGUAGE_NAME	Les chaînes de langue des paramètres d’entrée sont au format de nom de langue .

[in, optional] pwszLanguagesBuffer

Pointeur vers une mémoire tampon multi-chaîne double terminée par null qui contient une liste ordonnée et délimitée par un null dans l’ordre de préférence décroissant. S’il existe plus de cinq langues dans la mémoire tampon, la fonction définit uniquement les cinq premières langues valides.

Ce paramètre peut également contenir null si aucune liste de langues n’est requise. Dans ce cas, la fonction efface les langages d’interface utilisateur préférés pour le processus.

[out, optional] pulNumLanguages

Pointeur vers le nombre de langues qui ont été définies dans la liste des langues de processus à partir de la mémoire tampon d’entrée, jusqu’à un maximum de cinq.

Valeur retournée

Retourne TRUE si elle réussit ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, l’application peut appeler GetLastError, qui peut retourner le code d’erreur suivant :

ERROR_INVALID_PARAMETER. Un paramètre non valide est spécifié.

Si la liste des langues d’interface utilisateur préférées du processus est vide ou si les langues spécifiées pour le processus ne sont pas valides, la fonction réussit et définit 0 dans le paramètre pulNumLanguages .

Remarques

Dans l’idéal, les applications appellent SetProcessPreferredUILanguages dès que possible après le lancement.

Une fois cette fonction retournée, l’application peut appeler GetProcessPreferredUILanguages pour vérifier et examiner la liste des langues résultante.

Lorsque MUI_LANGUAGE_ID est spécifié, les chaînes de langage des paramètres d’entrée doivent utiliser un langage hexadécimal

identificateurs qui n’incluent pas le 0x de début et qui sont de 4 caractères. Par exemple, en-US doit être

est passé comme « 0409 » et en comme « 0009 ».

Note L’utilisation de MUI_LANGUAGE_NAME est recommandée sur MUI_LANGUAGE_ID.

C# Signature

[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
        static extern System.Boolean SetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            System.String pwszLanguagesBuffer,
            ref System.UInt32 pulNumLanguages
            );

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winnls.h (inclure Windows.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

GetProcessPreferredUILanguages

Interface utilisateur multilingue

Fonctions d’interface utilisateur multilingues

Partager via