OMget_obj_name, OMset_obj_name

Synopsis

int OMget_obj_name (OMobj_id object_id,
OMobj_name *object_name );
int OMset_obj_name (OMobj_id object_id,
OMobj_name object_name);

Description

These routines get and set an object's name.After you have changed an object's name, if this object may have any connections to it or to any of its subobjects, you should update these references by calling the routine OMupd_name_refs.

Arguments

object_id

The id of an object.

object_name

In OMget_obj_name, an output argument containing the object's name.In OMset_obj_name, an input argument specifying the new object name.

Returned value

The status code (see Return Status ).

Examples

/* Get object var1_id's name. */
OMobj_id _var1_id;
int status;
OMobj_name var1_name;
...
status = OMget_obj_name(var1_id, &var1_name);

See Also

OMupd_name_refs

OMret_obj_name