GetKeyboardLayoutList, fonction (winuser.h)

Récupère les identificateurs de paramètres régionaux d’entrée (anciennement appelés handles de disposition du clavier) correspondant à l’ensemble actuel de paramètres régionaux d’entrée dans le système. La fonction copie les identificateurs dans la mémoire tampon spécifiée.

Syntaxe

int GetKeyboardLayoutList(
  [in]  int nBuff,
  [out] HKL *lpList
);

Paramètres

[in] nBuff

Type : int

Nombre maximal de handles que la mémoire tampon peut contenir.

[out] lpList

Type : HKL*

Pointeur vers la mémoire tampon qui reçoit le tableau des identificateurs de paramètres régionaux d’entrée.

Valeur retournée

Type : int

Si la fonction réussit, la valeur de retour correspond au nombre d’identificateurs de paramètres régionaux d’entrée copiés dans la mémoire tampon ou, si nBuff est égal à zéro, la valeur de retour correspond à la taille, dans les éléments de tableau, de la mémoire tampon nécessaire pour recevoir tous les identificateurs régionaux d’entrée actuels.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

L’identificateur de paramètres régionaux d’entrée est un concept plus large qu’une disposition de clavier, car il peut également englober un convertisseur de reconnaissance vocale, un éditeur de méthode d’entrée (IME) ou toute autre forme d’entrée.

À partir de Windows 8 : La méthode par défaut pour récupérer la langue associée à la disposition du clavier ou à la méthode d’entrée actuelle est un appel à Windows.Globalization.Language.CurrentInputMethodLanguageTag. Si votre application transmet des balises de langue de CurrentInputMethodLanguageTag à n’importe quelle fonction de prise en charge des langues nationales , elle doit d’abord convertir les balises en appelant ResolveLocaleName.

Configuration requise

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Voir aussi

Conceptuel

GetKeyboardLayout

Entrées du clavier

Référence