]]>
]]>
tt_default_file
library call
tt_default_file
return the current default file
#include <Tt/tt_c.h>
char *tt_default_file
DESCRIPTION
The
tt_default_file function
returns the current default file.
When the application joins a file, the file becomes the default.
RETURN VALUE
Upon successful completion, the
tt_default_file function returns the pointer to a character string that specifies the
current default file.
If the pointer is
NULL, no default file is set.
The application can use
&cdeman.tt.ptr.error; to extract one of the following
Tt_status values from the returned pointer:
TT_OK
The operation completed successfully.
TT_ERR_NOMP
The
&cdeman.ttsession; process is not running and the ToolTalk service cannot restart it.
TT_ERR_PROCID
The current default process identifier is out of date or invalid.
APPLICATION USAGE
The application should use
&cdeman.tt.free; to free any data stored in the address returned by the
ToolTalk API.
SEE ALSO
&cdeman.Tt.tt.c.h;, &cdeman.tt.file.join;, &cdeman.tt.default.file.set;, &cdeman.tt.ptr.error;, &cdeman.tt.free;.