View source for LockupHook

This function is specific to OS/2 Version 2.1 or higher.

This hook is called when the system locks itself up.

==Syntax==
LockupHook(hab, hwndLockupFrame);

==Parameters==
;''hab'' (HAB) - input: The application anchor block.
;''hwndLockupFrame'' (HWND) - input: The frame window of the lockup panel.

==Returns==
There is no return value for this hook.

==Remarks==
The ''hwndLockupFrame'' parameter contains the frame window handle of the lockup dialog. All HK_LOCKUP hooks registered with the system are called when the system locks itself up. All HK_LOCKUP hooks must be system hooks, not message queue hooks.

Application programs that create other lockup password input windows by hooking the HK_LOCKUP system hook can use [[WinUnlockSystem]] to force the system to unlock when another form of input is detected other than mouse or keyboard. For example, a pen gesture or some voice input or signature recognition.

==Example Code==
<pre>
#define INCL_WINHOOKS /* Or use INCL_WIN, INCL_PM, */
#include <os2.h>

HAB  hab;             /* The application anchor block. */
HWND hwndLockupFrame; /* The frame window of the lockup panel. */

LockupHook(hab, hwndLockupFrame);
</pre>

==Related Functions==
* [[WinLockupSystem]]
* [[WinUnlockSystem]]
[[Category:Hooks and Procedures]]