en:docs:fapi:kbdfreefocus

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

2021/09/17 04:47 · prokushev · 0 Comments
2021/08/20 03:18 · prokushev · 0 Comments

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