GetProcessPreferredUILanguages, fonction (winnls.h)

Article
08/27/2023

Récupère les langues d’interface utilisateur préférées du processus. Pour plus d’informations, consultez Gestion des langues de l’interface utilisateur.

Syntaxe

BOOL GetProcessPreferredUILanguages(
  [in]            DWORD   dwFlags,
  [out]           PULONG  pulNumLanguages,
  [out, optional] PZZWSTR pwszLanguagesBuffer,
  [in, out]       PULONG  pcchLanguagesBuffer
);

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.

Valeur	Signification
MUI_LANGUAGE_ID	Récupérez les chaînes de langue au format d’identificateur de langue .
MUI_LANGUAGE_NAME	Récupérez les chaînes de langue au format de nom de langue .

[out] pulNumLanguages

Pointeur vers le nombre de langues récupérées dans pwszLanguagesBuffer.

[out, optional] pwszLanguagesBuffer

facultatif. Pointeur vers une mémoire tampon multi-chaîne double terminée par null dans laquelle la fonction récupère une liste ordonnée et délimitée par un null dans l’ordre de préférence, en commençant par le plus préférable.

Si ce paramètre a la valeur NULL et que pcchLanguagesBuffer a la valeur 0, la fonction récupère la taille requise de la mémoire tampon de langue dans pcchLanguagesBuffer. La taille requise inclut les deux caractères null.

[in, out] pcchLanguagesBuffer

Pointeur vers la taille, en caractères, pour la mémoire tampon de langue indiquée par pwszLanguagesBuffer. En cas de retour réussi à partir de la fonction, le paramètre contient la taille de la mémoire tampon de langue récupérée.

Si ce paramètre a la valeur 0 et que pwszLanguagesBuffer a la valeur NULL, la fonction récupère la taille requise de la mémoire tampon de langue dans pcchLanguagesBuffer.

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 l’un des codes d’erreur suivants :

ERROR_INSUFFICIENT_BUFFER. Une taille de mémoire tampon fournie n’était pas assez grande ou elle a été incorrectement définie sur NULL.
ERROR_INVALID_PARAMETER. L’une des valeurs de paramètre n’était pas valide.

Si la liste des langues d’interface utilisateur par défaut du processus est vide ou si les langues spécifiées pour le processus ne sont pas valides, la fonction réussit et retourne un multistring vide dans pwszLanguagesBuffer et 2 dans le paramètre pcchLanguagesBuffer .

Remarques

En fonction des indicateurs spécifiés par l’application, cette fonction peut récupérer une liste composée des langages d’interface utilisateur préférés du processus. Si elle rencontre une langue en double, la fonction récupère uniquement la première instance de la langue dupliquée.

Lorsque MUI_LANGUAGE_ID est spécifié, les chaînes de langue récupérées sont des identificateurs de langue hexadécimaux

qui n’incluent pas le 0x de début et auront une longueur de 4 caractères. Par exemple, en-US sera retourné

en tant que « 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 GetProcessPreferredUILanguages(
            System.UInt32 dwFlags,
            ref System.UInt32 pulNumLanguages,
            System.IntPtr pwszLanguagesBuffer,
            ref System.UInt32 pcchLanguagesBuffer
            );

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

Interface utilisateur multilingue

Fonctions d’interface utilisateur multilingues

SetProcessPreferredUILanguages

Partager via