XvSessionSavePath()(3X) — Subroutines
NAME
XvSessionSavePath — returns a path and file name for an application to save session information to.
SYNOPSIS
#include <Xv/Session.h> Boolean XvSessionSavePath(widget, ∗∗savePath, ∗∗saveFile)
Widgetwidget;
char∗∗savePath;
char∗∗saveFile;
ARGUMENTS
widgetSpecifies the application’s top level widget.
savePathReturns the path for the application to save to.
saveFileReturns the file name to be saved in -session.
DESCRIPTION
XvSessionSavePath returns a path for an application to save session information to. The information is used later to restore the application to the state it was last in when the session is restored. savePath is the fully qualified path name of the file. saveFile is the file name (no path) which is saved on the command line using a -session option. saveFile is used on session startup in the XvSessionRestorePath() call to get the full path of the file to restore from.
RETURN VALUE
Returns True if the path can be created and the memory allocated, False otherwise. Both savePath and saveFile are malloc’d by the routine, and the memory for them needs to be freed (using XtFree).
ORIGIN
Hewlett-Packard Company