hpux man page for dtsavergetwindows

DtSaverGetWindows(library call) 										   DtSaverGetWindows(library call)

NAME
       DtSaverGetWindows -- get the list of windows for drawing by a screen saver application

SYNOPSIS
       #include <Dt/Saver.h>
       Boolean DtSaverGetWindows(
       Display *display,
       Window **window,
       int *count);

DESCRIPTION
       The DtSaverGetWindows function returns a list of windows on which a screen saver application should draw when invoked by CDE.

       The  display  argument is the X display.  The window argument is the address of a pointer to receive the pointer to a list of windows.  The
       count argument is the address of an integer to receive the number of elements in the list of windows returned in window.

RETURN VALUE
       Upon successful completion, the DtSaverGetWindows function returns True; otherwise, it returns False.

APPLICATION USAGE
       If the DtSaverGetWindows function is not successful, failure may be due to a memory allocation error or that the screen	saver  application
       was not invoked from CDE.

       The application must use XtFree(3) to free data returned in *window.

SEE ALSO
       Dt/Saver.h - DtSaver(5); XtFree(3).

														   DtSaverGetWindows(library call)