Funzione GetKeyboardLayoutList (winuser.h)
Recupera gli identificatori delle impostazioni locali di input (in precedenza denominati handle di layout della tastiera) corrispondenti al set corrente di impostazioni locali di input nel sistema. La funzione copia gli identificatori nel buffer specificato.
Sintassi
int GetKeyboardLayoutList(
[in] int nBuff,
[out] HKL *lpList
);
Parametri
[in] nBuff
Tipo: int
Numero massimo di handle che il buffer può contenere.
[out] lpList
Tipo: HKL*
Puntatore al buffer che riceve la matrice di identificatori delle impostazioni locali di input.
Valore restituito
Tipo: int
Se la funzione ha esito positivo, il valore restituito è il numero di identificatori delle impostazioni locali di input copiati nel buffer o, se nBuff è zero, il valore restituito è la dimensione, negli elementi della matrice, del buffer necessario per ricevere tutti gli identificatori delle impostazioni locali di input correnti.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
L'identificatore delle impostazioni locali di input è un concetto più ampio di un layout della tastiera, poiché può anche includere un convertitore voce a testo, un editor di metodi di input (IME) o qualsiasi altra forma di input.
A partire da Windows 8: Il metodo preferito per recuperare la lingua associata al layout della tastiera corrente o al metodo di input è una chiamata a Windows.Globalization.Language.CurrentInputMethodLanguageTag. Se l'app passa tag di lingua da CurrentInputMethodLanguageTag a qualsiasi funzione di supporto linguistico nazionale, deve prima convertire i tag chiamando ResolveLocaleName.
Requisiti
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | winuser.h (include Windows.h) |
| Libreria | User32.lib |
| DLL | User32.dll |
Vedi anche
Informazioni concettuali
Riferimento