DestroyWindow( hWnd ) -> < lSuccess >
------------------------------------------------------------------------------


 PARAMETER:

  <hwnd>     Handle of the window that will be destroyed

  
 RETURNS:

  <lSuccess> TRUE if the operation was successful


 DESCRIPTION:

  DestroyWindow() destructs the specified window. It therefore sends the
  appropriate messages to the window to deactivate it and removes the input 
  focus. Then it destroys the windows menu, flushes the application queue,
  kills outstanding timers, removes clipboard ownership, and breaks the 
  clipboard-viewer chain, if the window is at the top of it.     
  
  Finally it sends WM_DESTROY and WM_NCDESTROY messages to the
  window. If the given window is the parent of any windows, DestroyWindow
  automatically destroys these child windows when it destroys the parent 
  window. The function destroys child windows first, and then the window 
  itself. DestroyWindow also destroys modeless dialog boxes.

  FiveWin manages all these functions automatically through Classes.  


 SOURCE:

  SOURCE\WINAPI\WNDDESTR.C