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

GetKeyboardLayout

Input della tastiera

Riferimento