Update API docs for TelephonyManager#registerTelephonyCallback.

Call out the fact that you need to hold permissions stated on the
listeners you are trying to register at callback registration time.

Fixes: 203364716
Test: Docs only change; no tests required.
Change-Id: I267c8b23b2180ca074fddf48737f743039419998
This commit is contained in:
Tyler Gunn
2022-07-13 10:45:36 -07:00
parent 1622d409d9
commit 90af8af512

View File

@@ -16038,7 +16038,12 @@ public class TelephonyManager {
* the appropriate callback method on the callback object and passes the current (updated)
* values.
* <p>
*
* Note: Be aware of the permission requirements stated on the {@link TelephonyCallback}
* listeners you implement. Your application must be granted these permissions in order to
* register a {@link TelephonyCallback} which requires them; a {@link SecurityException} will be
* thrown if you do not hold the required permissions for all {@link TelephonyCallback}
* listeners you implement.
* <p>
* If this TelephonyManager object has been created with {@link #createForSubscriptionId},
* applies to the given subId. Otherwise, applies to
* {@link SubscriptionManager#getDefaultSubscriptionId()}. To register events for multiple