Returns a value iterator that can be used to sequence through the values assigned to the entry currently being referenced by the specified entry iterator.
#include "am_map.h" AM_EXPORT am_status_t am_map_entry_iter_get_values(am_map_entry_iter_t entry_iter, am_map_value_iter_t *value_iter_ptr);
This function takes the following parameters:
The specified entry iterator.
Pointer specifying the location of the value iterator.
This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If no error was detected.
If unable to allocate memory for the key iterator.
If the value_iter_ptr argument is NULL.
If value_iter_ptr is not NULL and an error is returned, the location that it references will be set to NULL.
If the entry_iter argument is NULL or does not reference a valid entry.
After using am_map_value_iter_t, the caller must call am_map_value_iter_destroy().