KbdSetCp

Description

This function supports the code page switching for the keyboard. It sets to an installed code page, which is loaded if necessary.

Sets the current keyboard code page used to translate keystrokes received from the keyboard. This causes a change in the translation of keys. The code page can be any code page (except EBCDIC to DBCS). Setting this code page does not affect the display or process code pages.

Syntax

#define INCL_KBD
#include <os2.h>

ULONG     ulReserved;  /*  Reserved.  Must be 0. */
USHORT    pidCP;       /*  Code page ID. */
HKBD      hkbd;        /*  Reserved.  Must be 0. */
APIRET    rc;          /*  Return Code. */

rc = KbdSetCp(ulReserved, pidCP, hkbd);

Parameters

ulReserved (ULONG) - input

Reserved. Must be 0.

pidCP (USHORT) - input

Code page ID.

The code page ID must be the ID of a code page installed on the system or zero.

hkbd (HKBD) - input

Reserved. Must be 0.

Return Code

rc (APIRET) - returns

KbdSetCp returns one of the following values:

• 0 NO_ERROR
• 439 ERROR_KBD_INVALID_HANDLE
• 445 ERROR_KBD_FOCUS_REQUIRED
• 447 ERROR_KBD_KEYBOARD_BUSY
• 448 ERROR_KBD_INVALID_CODEPAGE
• 504 ERROR_KBD_EXTENDED_SG