UnloadKeyboardLayout-Funktion (winuser.h)

Artikel
08/28/2023

Entlädt einen Eingabe-Gebietsschemabezeichner (früher als Tastaturlayout bezeichnet)

Syntax

BOOL UnloadKeyboardLayout(
  [in] HKL hkl
);

Parameter

[in] hkl

Typ: HKL

Der zu entladende Eingabegebietsschemabezeichner.

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. Die Funktion kann aus den folgenden Gründen fehlschlagen:

Ein ungültiger Eingabegebietsschemabezeichner wurde übergeben.
Der Eingabegebietsschemabezeichner wurde vorab geladen.
Der Eingabegebietsschemabezeichner wird verwendet.

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.

UnloadKeyboardLayout kann den Standard-Gebietsschemabezeichner des Systems nicht entladen, wenn es sich um das einzige geladene Tastaturlayout handelt. Sie müssen zuerst einen anderen Eingabegebietsschemabezeichner laden, bevor Sie den Standard-Gebietsschemabezeichner entladen.

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