GetKeyboardLayoutNameA-Funktion (winuser.h)
Ruft den Namen des aktiven Eingabegebietsschemabezeichners (früher als Tastaturlayout bezeichnet) für den aufrufenden Thread ab.
Syntax
BOOL GetKeyboardLayoutNameA(
[out] LPSTR pwszKLID
);
Parameter
[out] pwszKLID
Typ: LPTSTR-
Der Puffer (mindestens KL_NAMELENGTH Zeichen lang), der den Namen des Eingabegebietsschemabezeichners erhält, einschließlich des endenden NULL-Zeichens. Dies ist eine Kopie der Zeichenfolge, die dem LoadKeyboardLayout-Funktion bereitgestellt wird, es sei denn, die Layoutersetzung wurde durchgeführt.
Eine Liste der Eingabelayouts, die mit Windows bereitgestellt werden, finden Sie unter Tastatur-IDs und Eingabemethoden-Editoren für Windows.
Rückgabewert
Typ: BOOL-
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert null. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Der Eingabegebietsschemabezeichner ist ein breiteres Konzept als ein Tastaturlayout, da es auch einen Sprach-zu-Text-Konverter, einen Eingabemethoden-Editor (INPUT Method Editor, IME) oder eine andere Art von Eingabe umfassen kann.
Ab Windows 8: Die bevorzugte Methode zum Abrufen der Sprache, die dem aktuellen Tastaturlayout oder der Eingabemethode zugeordnet ist, ist ein Aufruf von Windows.Globalization.Language.CurrentInputMethodLanguageTag. Wenn Ihre App Sprachtags von CurrentInputMethodLanguageTag an alle Funktionen National Language Support übergibt, muss sie zuerst die Tags durch Aufrufen von ResolveLocaleNamekonvertieren.
Anmerkung
Der winuser.h-Header definiert GetKeyboardLayoutName als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winuser.h (enthalten Windows.h) |
| Library | User32.lib |
| DLL- | User32.dll |
Siehe auch
Konzeptionelle
Referenz-