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().