Function Name: Has Associations

Definition

Determines whether an object has associations to other SEDRIS objects.

What counts as an association and what doesn't?

For the purposes of this function:

• Aggregations don't count.
• One-way associations 'to' this object don't count.
• One-way associations 'from' this object do count.
• Two-way associations in which this object is involved do count.
• 'link' objects (sometimes called 'association' objects) don't count. Consider an association object, called object O, attached to an association between objects A and B. Objects A and B have an association between themselves, but by definition object O does not have an association to object A or to object B.

Returns

SE_NULL_REQUIRED_PARAMETER - and *result_out_ptr is left unaltered, if result_out_ptr was NULL.

SE_INVALID_OR_NULL_OBJECT - and *result_out_ptr is set to SE_FALSE, if object_in isn't a handle to a valid, active (i.e., unfreed) SEDRIS object.

SE_UNRESOLVED_START_OBJECT - and *result_out_ptr is set to SE_FALSE, if object_in is currently unresolved (see SE_OBJECT's comments for details on how this condition occurs).

SE_FAILURE - and *result_out_ptr is set to SE_FALSE, if

1. drm_class holds an invalid value,
2. inter_transmittal_referencing_traversal holds an invalid value,
3. the API implementation specified does not provide this function in its shared library, and dynamic binding is specified at compile time.

Prototype

Parameters Notes

object_in

 the SEDRIS object for which the user wants to know whether
    any associations exist.

drm_class

 the DRM class of associate desired. If
    SE_NULL_TOKEN is passed in, then any associated object will do.
    Asking for an object of an abstract DRM class is allowed; in that case,
    the API will look for associations to concrete objects that are
    descendants of the of the given abstract DRM class.

inter_transmittal_referencing_traversal

 the user must choose how
    the function will behave when it encounters an Inter-Transmittal
    Reference (ITR). The function could automatically resolve such
    references and continue the search within the new transmittal;
    report all ITR references without resolving them; or just ignore
    them completely and continue to search within the current
    transmittal.

result_out_ptr

 a pointer to the variable in the user's memory space
    where the answer will be stored.