Returns an iterator object that can be used to sequence through the entries in the specified properties object.
#include "am_properties.h" AM_EXPORT am_status_t am_properties_get_entries(am_properties_t properties, am_properties_iter_t *properties_iter_ptr);
This function takes the following parameters:
The specified properties object.
Pointer to the location of the new properties iterator object.
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 iterator object.
If properties_iter_ptr is NULL. If properties_iter_ptr is not NULL and an error is returned, the location that it refers to will be set to NULL.
If the specified properties object contains no entries.