Makes a copy of a properties object.
#include "am_properties.h" AM_EXPORT am_status_t am_properties_copy(am_properties_t source_properties, am_properties_t *properties_ptr);
This function takes the following parameters:
The handle for the properties object to be copied.
A pointer to where to store the handle of the new created properties object.
This function returns am_status_t with one of the following values:
If a properties object was successfully copied.
If unable to allocate memory for the new properties object.
If the source_properties or properties_ptr argument is NULL.
Creates an instance of am_properties_t and assigns it to properties_ptr. The function copies all the elements in the source_ptr to properties_ptr. The source_ptr is not affected during this operation.
Memory Concerns: After the usage of the instance properties_ptr the caller must call am_properties_destroy to clean up the allocated memory. The removal of any item in either structures do not affect the other.