OMget_ref_to_list


Synopsis


int OMget_ref_to_list(
OMobj_id  object_id,
int  *num_refs,
OMobj_id  **ref_id_list,
int  mode);

Description

This routine returns the list of objects that are connected to the object specified by object_id. This goes in the opposite direction from the OMget_num_refs and OMget_array_refs routines.

Arguments

object_id

The id of the object whose connections are returned.

num_refs

The number of connections to this object.

ref_id_list

A pointer to an array of object ids that are connected to this object. This list is allocated with the C malloc call and must be freed by you when you are done with the list.

mode

The mode in which this routine performs this operation:

Mode value

 

Behavior

 

0

Returns the ids of all objects that have names (i.e., are not intermediate link objects in the referencing chain to this object).

OM_REF_TO_VALUE

Returns the ids of intermediate name-link objects instead of returning just the objects that have names in the object hierarchy. You typically do not want to use this mode since these objects are usually safe to ignore.

OM_REF_TO_SOURCE

Skips to the end of a chain of connections. You often want to use this mode since it skips intermediate link objects.

 

Returned value

A status code. See Return Status .