DtSessionSavePath(UNIX System V (1 August 199DtSessionSavePath(3)
NAME
DtSessionSavePath - get a pathname for saving application
state information
SYNOPSIS
#include <Dt/Session.h>
Boolean DtSessionSavePath(Widget widget,
char **savePath,
char **saveFile);
DESCRIPTION
The DtSessionSavePath() function returns the pathname to be
used by an application for saving its state information.
The information is later used by the application to restore
its state.
The widget argument is the application's top level widget.
The savePath argument is the address of the character string
to receive the pathname of the state information file to be
used by the application for storing its state. The saveFile
argument is the address of the character string to receive
the filename of the file to be used by the application for
storing its state.
RETURN VALUE
Upon successful completion, the DtSessionSavePath() function
returns True; otherwise, it returns False.
APPLICATION USAGE
The application should add -session saveFile when it updates
its WM_COMMAND property.
The application must use XtFree(3X) to free data returned in
*savePath and *saveFile.
SEE ALSO
DtSession(5), DtSessionRestorePath(3); XtFree(3X).
Page 1 (printed 9/3/04)