Returns

This function returns am_status_t with one of the following values:

AM_SUCCESS

If no error is detected.

AM_NSPR_ERROR

If there is a problem writing the properties to the file.

AM_INVALID_ARGUMENT

If properties or file_name is NULL or file_name points to an empty string.