Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 744d5a46 authored by Gil Cukierman's avatar Gil Cukierman
Browse files

Update TelephonyManager.setAllowedNetworkTypeForReason Docs 

Test: N/A
Bug: 245322623
Change-Id: I26ca0d0cadf467b02db5f63f0ce66a72afa18fa9
parent 6c70a328

telephony/java/android/telephony/TelephonyManager.java

+11 −4
Original line number Original line Diff line number Diff line
@@ -9409,12 +9409,13 @@ public class TelephonyManager { 
    /**

    /**

     * Set the allowed network types of the device and provide the reason triggering the allowed

     * Set the allowed network types of the device and provide the reason triggering the allowed

     * network change.

     * network change.

     * <p>Requires permission: android.Manifest.MODIFY_PHONE_STATE or

     * <p>Requires permission: {@link android.Manifest.permission#MODIFY_PHONE_STATE} or

     * that the calling app has carrier privileges (see {@link #hasCarrierPrivileges}).

     * that the calling app has carrier privileges (see {@link #hasCarrierPrivileges}).

     *

     *

     * This can be called for following reasons

     * This can be called for following reasons:

     * <ol>

     * <ol>

     * <li>Allowed network types control by USER {@link #ALLOWED_NETWORK_TYPES_REASON_USER}

     * <li>Allowed network types control by USER

     * {@link TelephonyManager#ALLOWED_NETWORK_TYPES_REASON_USER}

     * <li>Allowed network types control by carrier {@link #ALLOWED_NETWORK_TYPES_REASON_CARRIER}

     * <li>Allowed network types control by carrier {@link #ALLOWED_NETWORK_TYPES_REASON_CARRIER}

     * </ol>

     * </ol>

     * This API will result in allowing an intersection of allowed network types for all reasons,

     * This API will result in allowing an intersection of allowed network types for all reasons,
@@ -9424,7 +9425,13 @@ public class TelephonyManager { 
     * @param allowedNetworkTypes The bitmask of allowed network type

     * @param allowedNetworkTypes The bitmask of allowed network type

     * @throws IllegalStateException if the Telephony process is not currently available.

     * @throws IllegalStateException if the Telephony process is not currently available.

     * @throws IllegalArgumentException if invalid AllowedNetworkTypesReason is passed.

     * @throws IllegalArgumentException if invalid AllowedNetworkTypesReason is passed.

     * @throws SecurityException if the caller does not have the required privileges

     * @throws SecurityException if the caller does not have the required privileges or if the

     * caller tries to use one of the following security-based reasons without

     * {@link android.Manifest.permission#MODIFY_PHONE_STATE} permissions.

     * <ol>

     *     <li>{@code TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_ENABLE_2G}</li>

     *     <li>{@code TelephonyManager.ALLOWED_NETWORK_TYPES_REASON_USER_RESTRICTIONS}</li>

     * </ol>

     */

     */

    @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)

    @RequiresPermission(android.Manifest.permission.MODIFY_PHONE_STATE)

    @RequiresFeature(

    @RequiresFeature(