SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API
Functions
SE InitializeInheritedComponentIterator
extern SE_Return_Code
SE_InitializeInheritedComponentIterator
(
SE_Object start_object,1
SE_Search_Filter filter,2
SE_Boolean directly_attach_table_components,3
SE_ITR_Behaviour itr_traversal,4
SE_Iterator *iterator_out_ptr5
);

Definition

Creates an iterator to (traverse over the list of)/(return pointers to) component objects that were inherited.

If you just want the inherited components of an object, then use this function call.

If you just want the directly aggregated components of an object, then use the SE_InitializeComponentIterator() function with the process_inheritance parameter set to SE_FALSE.

If you want both the inherited components and the directly aggregated components of an object (and don't care to distinguish between the two sets) then use the SE_InitializeComponentIterator() function with the process_inheritance parameter set to SE_TRUE.


Returns

SE_RETCOD_SUCCESS and the iterator is initialized.
SE_RETCOD_FAILURE and the status code is set appropriately if the call failed.

Status Codes

SE_Status_Code(s) when SE_RETCOD_SUCCESS is returned:

SE_STATCODE_SUCCESS set if valid parameters were passed in and all operations succeeded.

SE_Status_Code(s) when SE_RETCOD_FAILURE is returned:

SE_STATCODE_UNRESOLVED_INPUT_OBJECT set if start_object is currently unresolved (see SE_ObjectSE_Object's comments for details on how this condition occurs).
SE_STATCODE_C_ENUMERATION_VALUE_INVALID set if itr_traversal is not a valid value.
SE_STATCODE_INACTIONABLE_FAILURE set if
  1. a search filter is provided, but is not a handle to a valid, active (i.e., unfreed) search filter,
  2. the start_object and search_filter came from different API implementations, or
  3. the call fails for any other reason

Parameters Notes

1 object whose list of inherited components will be returned.

2 a search filter that will be used to filter the output of this iterator.

3 see comments in SE_InitializeComponentIterator().

4 see comments in SE_InitializeComponentIterator().

5 a pointer to the freshly created iterator that will iterate over the inherited components of the start_object. If a search filter was provided, then only the inherited components that pass that search filter will be included in the list.


Prev: SE_InitializeComponentIterator. Next: SE_IsIteratorComplete. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS