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
Référence