This function returns am_status_t with one of the following values:
If no error was detected.
If unable to allocate memory for the value iterator object.
If the value_iter_ptr argument is NULL.
If the specified iterator is NULL or does not reference a valid entry.