Get the current status of the iterator. Call this after a function
returns \c false to get the reason for the error. Also resets the status
to FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK.
\param iterator A pointer to an existing iterator.
\assert
\code iterator != NULL \endcode
\retval FLAC__Metadata_SimpleIteratorStatus
The current status of the iterator.
Get the current status of the iterator. Call this after a function returns \c false to get the reason for the error. Also resets the status to FLAC__METADATA_SIMPLE_ITERATOR_STATUS_OK.
\param iterator A pointer to an existing iterator. \assert \code iterator != NULL \endcode \retval FLAC__Metadata_SimpleIteratorStatus The current status of the iterator.