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: I8b35cfe2b7dfff7166bacef43fe085c6c3bde6a4