GetKeyboardLayoutList-Funktion (winuser.h)
Ruft die Eingabe-Gebietsschemabezeichner (früher als Tastaturlayouthandles bezeichnet) ab, die den aktuellen Eingabegebietsschemas im System entsprechen. Die Funktion kopiert die Bezeichner in den angegebenen Puffer.
Syntax
int GetKeyboardLayoutList(
[in] int nBuff,
[out] HKL *lpList
);
Parameter
[in] nBuff
Typ: int
Die maximale Anzahl von Handles, die der Puffer enthalten kann.
[out] lpList
Typ: HKL*
Ein Zeiger auf den Puffer, der das Array von Eingabegebietsschemabezeichnern empfängt.
Rückgabewert
Typ: int
Wenn die Funktion erfolgreich ist, ist der Rückgabewert die Anzahl von Eingabegebietsschemabezeichnern, die in den Puffer kopiert wurden, oder, wenn nBuff null ist, der Rückgabewert die Größe des Puffers in Arrayelementen, die zum Empfangen aller aktuellen Eingabegebietsschemabezeichner erforderlich ist.
Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Der Eingabegebietsschemabezeichner ist ein umfassenderes Konzept als ein Tastaturlayout, da es auch einen Spracherkennungskonverter, einen Eingabemethoden-Editor (IME) oder eine andere Form der Eingabe umfassen kann.
Ab Windows 8: Die bevorzugte Methode zum Abrufen der Sprache, die dem aktuellen Tastaturlayout oder der aktuellen Eingabemethode zugeordnet ist, ist ein Aufruf von Windows.Globalization.Language.CurrentInputMethodLanguageTag. Wenn Ihre App Sprachtags von CurrentInputMethodLanguageTag an alle Funktionen der National Language Support übergeben, muss sie zuerst die Tags konvertieren, indem ResolveLocaleName aufgerufen wird.
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 (einschließlich Windows.h) |
| Bibliothek | User32.lib |
| DLL | User32.dll |
Siehe auch
Konzept
Referenz