Returns

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

If a module of the same name already exists, the module identifier of the existing module is returned.

AM_SUCCESS

If the addition was successful.

AM_INVALID_ARGUMENT

If name or id_ptr is NULL.

AM_NSPR_ERROR

If unable to initialize the logging framework.

AM_NO_MEMORY

If unable to allocate memory for the new module.

AM_FAILURE

If any other error is detected.