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.

 ◄Summary► ◄Example►                         ◄Up► ◄Contents► ◄Index► ◄Back►
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _wsetexit function specifies what a QuickWin application does
     when it exits (with a call to the exit function).
 
     QuickWin programs can optionally keep their windows on the screen
     after termination. How a program behaves at exit time depends on
     its current exit behavior setting. The _wsetexit function sets
     the exit behavior setting.
 
     This routine is used only in QuickWin programs; it is not part of
     the Windows API. For full details about QuickWin, see Chapter 8 of
     the Programming Techniques manual.
 
     The _wsetexit function takes one of three arguments:
 
     Value                 Meaning
 
     _WINEXITPROMPT        Prompt the user at exit time to determine
                           whether the windows stay on the screen
     _WINEXITNOPERSIST     The windows do not stay on the screen and
                           there is no prompt to the user
     _WINEXITPERSIST       The windows stay on the screen at exit
 
     If _WINEXITPERSIST is passed, or if _WINEXITPROMPT is passed and
     the user chooses to keep the windows on the screen, the windows
     stay visible, their contents can be copied and pasted, and their
     scroll bars can be used. However, the windows are closed to
     further I/O.
     See: _wclose
 
     The default exit behavior is _WINEXITPERSIST if you do not call
     _wsetexit.
 
     Return Value
 
     If successful, _wsetexit returns 0. A return value of -1 indicates
     an error.
                                    -♦-