This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If the map object was successfully copied.
If unable to allocate memory for the new map object.
If the source_map or map_ptr argument is NULL.