Destroys the properties object referenced by the provided handle.
#include "am_properties.h" AM_EXPORT void am_properties_destroy(am_properties_t properties);
This function takes the following parameters:
The handle for the properties object to be destroyed.
This function returns one of the following values:
If the operation was successful.
If properties argument is NULL.
Destroys an instance of am_properties_t.
Memory Concerns: Caller must make sure not to pass the same instance of am_properties_t to be destroyed more than once. After calling this function it is advised that the caller initializes properties to NULL.