Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update TelephonyManager.setAllowedNetworkTypeForReason Docs"

Browse Source
This commit is contained in:
Gil Cukierman
2022-11-17 14:02:55 +00:00
committed by Gerrit Code Review
parent 518111147d 744d5a4650
commit 44f53112ec
1 changed files with 11 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

15
telephony/java/android/telephony/TelephonyManager.java
View File

@@ -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(