GetKeyboardLayoutNameA-Funktion (winuser.h)

Artikel
07/21/2023

Ruft den Namen des aktiven Eingabegebietsgebietsbezeichners (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), der den Namen des Eingabegebietsschemabezeichners empfängt, einschließlich des abschließenden NULL-Zeichens. Dies ist eine Kopie der Zeichenfolge, die für die LoadKeyboardLayout-Funktion bereitgestellt wird, es sei denn, das Layout wurde ersetzt.

Eine Liste der Eingabelayouts, die mit Windows bereitgestellt werden, finden Sie unter Tastaturbezeichner und Eingabemethoden-Editoren für Windows.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Bemerkungen

Der Eingabegebietsschemabezeichner ist ein umfassenderes Konzept als ein Tastaturlayout, da er auch einen Spracherkennungskonverter, einen Eingabemethoden-Editor (IME) oder jede andere Form der 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 zur Unterstützung von Nationaler Sprache übergibt, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.

Hinweis

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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll