This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):
If no error is detected.
If there is a problem writing to the file.
If properties or file_name is NULL or file_name points to an empty string.