C Language and Libraries Help (clang.hlp) (Table of Contents; Topic list)
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.
_wclose
 Summary Example                         Up Contents Index Back
─────Run-Time Library───────────────────────────────────────────────────────
 
     The _wclose function closes a QuickWin window. The window must
     have been previously opened with the QuickWin function _wopen.
     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.
 
     To close a window opened with _wopen, pass its file handle to
     _wclose. To close a window opened with _fwopen, call the STDIO.H
     function fclose.
 
     The <persist> flag can have one of the following values:
 
     Value             Meaning
 
     _WINNOPERSIST     Erase the closed window
     _WINPERSIST       Leave the window on the screen
 
     If the window remains on the screen, another _wclose call to the
     same file handle with _WINNOPERSIST removes it. While the window
     remains visible, the user can copy and paste text in it, choose
     QuickWin menus, and operate the window's scroll bars.
 
     Regardless of which <persist> option is used, the window's file
     handle is closed to all further I/O. If a window is opened with the
     same title as a window closed with persistence, it will be a
     different window. Windows closed with persistence count against the
     total number of open windows (20 by default).
 
     Return Value
 
     The _wclose function returns 0 if successful. A return value of -1
     indicates an error, and errno is set to EBADF, indicating an
     invalid file-handle argument.
                                    -♦-