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.