Function Name: Has Components

Definition

Determines whether an object has components.

This function follows the same searching rules as SE_GetComponent().

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 is not 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 it
    has any components.

directly_attach_table_components

 see SE_InitializeComponentIterator()'s
     directly_attach_table_components comments.

process_inheritance

 if true, then inherited components will be
    considered as well as 'immediate' components.  If false, then only
    'immediate' components will be considered.

drm_class

 the type of component object the user is
    looking for.  If this is SE_NULL_TOKEN, then any object will do.

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.