Funzione GetKeyboardLayoutNameW (winuser.h)
Recupera il nome dell'identificatore delle impostazioni locali di input attivo (in precedenza denominato layout della tastiera) per il thread chiamante.
Sintassi
BOOL GetKeyboardLayoutNameW(
[out] LPWSTR pwszKLID
);
Parametri
[out] pwszKLID
Tipo: LPTSTR
Buffer (di almeno KL_NAMELENGTH caratteri in lunghezza) che riceve il nome dell'identificatore delle impostazioni locali di input, incluso il carattere null terminante. Questa sarà una copia della stringa fornita alla funzione LoadKeyboardLayout , a meno che non sia stata eseguita la sostituzione del layout.
Per un elenco dei layout di input forniti con Windows, vedere Identificatori di tastiera e Editor di metodi di input per Windows.
Valore restituito
Tipo: BOOL
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
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 metodo di input Editor (IME) o qualsiasi altra forma di input.
A partire da Windows 8: il metodo preferito per recuperare la lingua associata al layout o al metodo di input corrente è 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.
Nota
L'intestazione winuser.h definisce GetKeyboardLayoutName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
Requisito | Valore |
---|---|
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