This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

KbdFreeFocus

This call frees the logical-to-physical keyboard bond created by KbdGetFocus.

Syntax

KbdFreeFocus (KbdHandle)

Parameters

KbdHandle (HKBD) - input: Default keyboard or the logical keyboard.

Return Code

rc (USHORT) - return:Return code descriptions are:

0 NO_ERROR

439 ERROR_KBD_INVALID_HANDLE

445 ERROR_KBD_FOCUS_REQUIRED

464 ERROR_KBD_DETACHED

504 ERROR_KBD_EXTENDED_SG

Remarks

KbdFreeFocus may be replaced by issuing KbdRegister. Unlike other keyboard subsystem functions, the replaced KbdFreeFocus is called only if there is an outstanding focus.

Bindings

C

#define INCL_KBD USHORT rc = KbdFreeFocus(KbdHandle); HKBD KbdHandle; /* Keyboard handle */ USHORT rc; /* return code */

MASM

EXTRN KbdFreeFocus:FAR INCL_KBD EQU 1 PUSH WORD KbdHandle ;Keyboard handle CALL KbdFreeFocus Returns WORD