Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If no error was detected.

AM_NO_MEMORY

If unable to allocate memory for the properties iterator object.

AM_INVALID_ARGUMENT

If the properties_iter_ptr argument is NULL.

AM_NOT_FOUND

If the specified properties object contains no entries.