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
#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);