OMadd_to_refcnt


Synopsis


int  OMadd_to_refcnt (OMobj_id  object, 1  );

Description

OMadd_to_refcnt increments object 's reference count.

This routine is useful when you are storing the object in a way that is unknown to the Object Manager. It ensures that the object will not be deleted until you delete your reference. If you call OMadd_to_refcnt, you should decrement the refcnt when you are finished with object by calling OMdestroy_obj.

Arguments

object

The id of an object.

1

The second argument must be set to 1.

Returned value

The status code (see See Return Status ).

See also

•      See OMdestroy_obj