]]>
]]>
tt_spec_create
library call
tt_spec_create
create an in-memory spec for an object
#include <Tt/tt_c.h>
char *tt_spec_create
const char *filepath
DESCRIPTION
The
tt_spec_create function
creates a spec (in memory) for an object.
The application can use the
objid
returned in future calls to manipulate the object.
The
filepath argument is the name of the file.
RETURN VALUE
Upon successful completion, the
tt_spec_create function returns the identifier for this object.
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_DBAVAIL
The ToolTalk service could not access the
ToolTalk database needed for this operation.
TT_ERR_DBEXIST
The ToolTalk service could not access the
specified ToolTalk database in the expected place.
TT_ERR_NOMP
The
&cdeman.ttsession; process is not running and the ToolTalk service cannot restart it.
TT_ERR_OTYPE
The specified object type is not the name of an installed object type.
TT_ERR_PATH
The specified pathname included an unsearchable directory.
APPLICATION USAGE
The application should use
&cdeman.tt.free; to free any data stored in the address returned by the
ToolTalk API.
To make the object a permanent ToolTalk item or one visible to other
processes, the creating process must call
&cdeman.tt.spec.write;.
SEE ALSO
&cdeman.Tt.tt.c.h;, &cdeman.tt.spec.type.set;, &cdeman.tt.spec.write;, &cdeman.tt.ptr.error;, &cdeman.tt.free;.