en:docs:fapi:kbdfreefocus

This is an old revision of the document!


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

<PRE> #define INCL_KBD

USHORT rc = KbdFreeFocus(KbdHandle); HKBD KbdHandle; /* Keyboard handle */

USHORT rc; /* return code */ </PRE>

MASM

<PRE> EXTRN KbdFreeFocus:FAR INCL_KBD EQU 1

PUSH WORD KbdHandle ;Keyboard handle CALL KbdFreeFocus

Returns WORD </PRE>

Kbd