This function causes an application program to attempt to unlock the system by passing a text string that can be compared against the system lockup password that is stored in an encrypted form by the system.

If the string passed in matches the system lockup password, the lockup dialog is dismissed and the user is able to use his machine. Otherwise, the system remains in the locked up state.

OS/2 does not provide a method for querying pszPassword to find out the password. It is up to the developer to ask the user what the password is.

In order to execute WinUnlockSystem after a WinLockupSystem has been called, the WinUnlockSystem must be called from a separate thread because WinLockupSystem will not return until a password has been entered from the keyboard.

The LockupHook hook allows a PM application to customize system lockups.

In order for the window to appear as the top most window on the lockup screen, the WS_CLIPSIBLINGS flag must be used for the flStyle parameter in the WinCreateWindow or WinCreateStdWindow call.