Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_KBD
 
USHORT KbdSetCustXt(pusTransTbl, hkbd)
PUSHORT pusTransTbl;    /* pointer to translation table */
HKBD hkbd;              /* keyboard handle              */
 
The KbdSetCustXt function installs a custom translation table for the
specified logical keyboard. MS OS/2 uses the translation table to generate
character values for all subsequent keystrokes from the logical keyboard.
 
The KbdSetCustXt function does not copy the translation table, so the
process must maintain the table in memory while it is in use, where it
remains until the process calls the KbdSetCp or KbdSetCustXt function to set
another translation table, or calls the KbdClose function to close the
logical keyboard.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
pusTransTbl  Points to the translation table.
 
hkbd         Identifies the logical keyboard that uses the new code page.
             The handle must have been created previously by using the
             KbdOpen function.
 
Return Value
 
The return value is zero if the function is successful. Otherwise, it is an
error value, which may be one of the following:
 
     ERROR_KBD_DETACHED
     ERROR_KBD_INVALID_HANDLE
 
See Also
 
KbdClose, KbdOpen, KbdSetCp, KbdXlate
 
                                      ♦