Example 2: Component Iterators

SE_STATUS_CODE_ENUM SE_InitializeComponentIterator3

(

SE_OBJECT start_object,

SE_SEARCH_FILTER filter,

SE_ITERATOR *Iterator_out_ptr

);

The Iterator will traverse down from start_object and find all objects matching the criteria stored in the search filter.

This is a C language macro that resolves to SE_InitializeComponentIterator() with defaults passed for more advanced argument features of Iterators.

SE_ITERATOR is an opaque type that is allocated by the API, and so must be freed with SE_FreeIterator().

SE_STATUS_CODE_ENUM SE_ FreeIterator

(

SE_ITERATOR Iterator

);