GetKeyboardLayoutNameA, fonction (winuser.h)
Récupère le nom de l’identificateur de paramètres régionaux d’entrée actif (anciennement appelé disposition du clavier) pour le thread appelant.
Syntaxe
BOOL GetKeyboardLayoutNameA(
[out] LPSTR pwszKLID
);
Paramètres
[out] pwszKLID
Type : LPTSTR
Mémoire tampon (d’au moins KL_NAMELENGTH caractères de longueur) qui reçoit le nom de l’identificateur de paramètres régionaux d’entrée, y compris le caractère null de fin. Il s’agit d’une copie de la chaîne fournie dans la fonction LoadKeyboardLayout, sauf si la substitution de disposition a eu lieu.
Pour obtenir la liste des dispositions d’entrée fournies avec Windows, consultez Identificateurs clavier et éditeurs de méthode d’entrée pour Windows.
Valeur de retour
Type : BOOL
Si la fonction réussit, la valeur de retour est différente de zéro.
Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations d’erreur étendues, appelez GetLastError.
Remarques
L’identificateur des 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.
À compter de Windows 8 : La méthode préférée 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 National Language Support, elle doit d’abord convertir les balises en appelant ResolveLocaleName.
Note
L’en-tête winuser.h définit GetKeyboardLayoutName comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winuser.h (include Windows.h) |
| bibliothèque | User32.lib |
| DLL | User32.dll |
Voir aussi
conceptuelle
de référence