Apply API council recommendation for existing API name and documentation

1. Suggest rename to RESULT_SMS_SEND_FAILED_AFTER_MAX_RETRY to match naming of RESULT_SMS_SEND_RETRY_FAILED.
2. add additional javadoc to explain the difference between these two.

Bug: 418840544
Flag: com.android.internal.telephony.flags.satellite_25q4_apis
Test: build test
Change-Id: Id2fddc8d64d3acab834e5d55a7545276b4235f3b