GetKeyboardType

The GetKeyboardType function retrieves information about the current keyboard.

int GetKeyboardType(
  int nTypeFlag   // type of information to retrieve
);
 

Parameters

nTypeFlag
Specifies the type of keyboard information to be retrieved. This parameter can be one of the following values:
Value Meaning
0 Keyboard type
1 Keyboard subtype
2 Number of function keys on the keyboard

Return Values

If the function succeeds, the return value specifies the requested information.

If the function fails, the return value is zero. To get extended error information, call GetLastError.

Remarks

The subtype is an original equipment manufacturer (OEM)-dependent value. The type may be one of the following values:

Value Meaning
1 IBM PC/XT or compatible (83-key) keyboard
2 Olivetti "ICO" (102-key) keyboard
3 IBM PC/AT (84-key) or similar keyboard
4 IBM enhanced (101- or 102-key) keyboard
5 Nokia 1050 and similar keyboards
6 Nokia 9140 and similar keyboards
7 Japanese keyboard

The application can also determine the number of function keys on a keyboard from the keyboard type. Following are the number of function keys for each keyboard type:

Type Number of function keys
1 10
2 12 (sometimes 18)
3 10
4 12
5 10
6 24
7 Hardware dependent and specified by the OEM

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

System Information Overview, System Information Functions