Returns

This function returns one of the following values:

Other codes

If the function returns any code other than AM_SUCCESS, the iteration will terminate and the same status code will be returned to the user.

AM_INVALID_ARGUMENT

If the parameters are invalid.