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

Commit af2c8359 authored by Gil Cukierman's avatar Gil Cukierman Committed by Automerger Merge Worker
Browse files

Merge "Update TelephonyManager.setAllowedNetworkTypeForReason Docs" am: 44f53112 

Original change: https://android-review.googlesource.com/c/platform/frameworks/base/+/2240933



Change-Id: Icc26671e9b9cbd14389d86bff36b30a0489ef07f
Signed-off-by: default avatarAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>
parents 42bfb0ae 44f53112

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(