hpux man page for xdestroywindow

XDestroyWindow()														  XDestroyWindow()

Name
  XDestroyWindow - unmap and destroy a window and all subwindows.

Synopsis
  XDestroyWindow(display, w)
	Display *display;
	Window w;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies the ID of the window to be destroyed.

Description
  If  w  is  mapped, an UnmapWindow request is performed automatically.  The window and all inferiors (recursively) are then destroyed, and a
  DestroyNotify event is generated for each window.  The ordering of the DestroyNotify events is such that for any given  window,  DestroyNo-
  tify	is generated on all inferiors of the window before being generated on the window itself.  The ordering among siblings and across sub-
  hierarchies is not otherwise constrained.

  The windows should never again be referenced.

  Destroying a mapped window will generate exposure events on other windows that were obscured by the windows being destroyed.	 XDestroyWin-
  dow() may also generate EnterNotify events if w was mapped and contained the pointer.

  No windows are destroyed if you try to destroy the root window.

Errors
  BadWindow

See Also
  XCreateSimpleWindow(), XCreateWindow(), XDestroySubwindows().

Xlib - Window Existence 													  XDestroyWindow()