Returns

This function returns one of the following values of the am_status_t enumeration (defined in the <am_types.h> header file):

AM_SUCCESS

If the logging file is successfully set.

AM_NO_MEMORY

If unable to allocate memory for internal data structures.

AM_FAILURE

If an error of any type occurs.