Compartilhar via


Função SetKeyboardState (winuser.h)

Copia uma matriz de estados de tecla de teclado na tabela de estado de entrada do teclado do thread de chamada. Essa é a mesma tabela acessada pelas funções GetKeyboardState e GetKeyState. As alterações feitas nesta tabela não afetam a entrada do teclado em nenhum outro thread.

Sintaxe

BOOL SetKeyboardState(
  [in] LPBYTE lpKeyState
);

Parâmetros

[in] lpKeyState

Tipo: LPBYTE

Um ponteiro para uma matriz de 256 bytes que contém estados de tecla de teclado.

Retornar valor

Tipo: BOOL

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Como a função SetKeyboardState altera o estado de entrada do thread de chamada e não o estado de entrada global do sistema, um aplicativo não pode usar SetKeyboardState para definir as luzes de indicador NUM LOCK, CAPS LOCK ou SCROLL LOCK (ou KANA japonês) no teclado. Eles podem ser definidos ou limpos usando SendInput para simular pressionamentos de tecla.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também