OMget_obj_name and 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 ).

Example


/* 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