Share via

SetKeyboardState-Funktion (winuser.h)

  • Artikel

Kopiert ein Array von Tastaturtastenzuständen in die Tastatureingabezustandstabelle des aufrufenden Threads. Auf diese Tabelle wird auch von den Funktionen GetKeyboardState und GetKeyState zugegriffen. An dieser Tabelle vorgenommene Änderungen wirken sich nicht auf die Tastatureingabe in einem anderen Thread aus.

Syntax

BOOL SetKeyboardState(
  [in] LPBYTE lpKeyState
);

Parameter

[in] lpKeyState

Typ: LPBYTE

Ein Zeiger auf ein 256-Byte-Array, das Tastaturtastenzustände enthält.

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.

Hinweise

Da die SetKeyboardState-Funktion den Eingabezustand des aufrufenden Threads und nicht den globalen Eingabestatus des Systems ändert, kann eine Anwendung SetKeyboardState nicht verwenden, um die Indikatorleuchten NUM LOCK, CAPS LOCK oder SCROLL LOCK (oder die japanische KANA) auf der Tastatur festzulegen. Diese können mithilfe von SendInput festgelegt oder gelöscht werden, um Tastenanschläge zu simulieren.

Anforderungen

Anforderung Wert
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

Weitere Informationen