Returns an iterator object that can be used to enumerate all of the entries in the specified properties object. See also am_properties_get() .
#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 handle for the properties object to be examined
Pointer to where the handle for the new properties iterator object should be stored.
This function returns am_status_t with one of the following values:
If no error was detected.
If unable to allocate memory for the properties iterator object.
If the properties_iter_ptr argument is NULL.
If the specified properties object contains no entries.
If the properties_iter_ptr argument is non-NULL, then the location that it refers to will be set to NULL if an error is returned.
See also am_properties_get().