]]>
]]>
tt_spec_propname
library call
tt_spec_propname
return an element of the property name list for an object spec
#include <Tt/tt_c.h>
char *tt_spec_propname
const char *objid
int n
DESCRIPTION
The
tt_spec_propname function
returns the
nth element of the property name list for this object spec.
The
objid argument is the identifier of the object involved in this operation.
The
n argument is the item of the list whose element is to be returned.
The list numbering
begins with zero.
RETURN VALUE
Upon successful completion, the
tt_spec_propname function returns the property name.
If there are
n properties or less,
tt_spec_propname returns
NULL. 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_NUM
The integer value passed was invalid (out of range).
TT_ERR_OBJID
The
objid passed to the ToolTalk service does not reference an existing object spec.
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.ptr.error;, &cdeman.tt.free;.