Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

                                                      ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMESSAGEMGR
 
BOOL WinCancelShutdown(hmq, fCancelAlways);
HMQ hmq;               /* handle of the message queue */
BOOL fCancelAlways;    /* status of WM_QUIT message   */
 
The WinCancelShutdown function allows a thread to function after receiving a
WM_QUIT message. The thread must call the WinCancelShutdown function,
passing its message-queue handle for identification. If the thread owns the
active window, that window is pushed to the bottom and deactivated.
WinCancelShutdown maintains a list of queues associated with the threads
that called it to avoid sending another WM_QUIT message to the same thread
later.
 
Parameter      Description
────────────────────────────────────────────────────────────────────────────
 
hmq            Identifies the message queue for the current thread.
 
fCancelAlways  Specifies whether the thread receives WM_QUIT messages during
               system shutdown. If this parameter is TRUE, the thread does
               not receive WM_QUIT messages during system shutdown. Note
               that this does not prevent a WM_QUIT message from being put
               into the queue for this thread by some other mechanism. If
               this parameter is FALSE, the thread ignores the WM_QUIT
               message. Note that a subsequent system shutdown causes a new
               WM_QUIT message to be sent to this thread.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
See Also
 
WM_QUIT
 
                                      ♦