DevicePolicyManager.SetPackagesSuspended Method

Reference

Definition

Namespace:: Android.App.Admin

Assembly:: Mono.Android.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Called by device or profile owners to suspend packages for this user.

[Android.Runtime.Register("setPackagesSuspended", "(Landroid/content/ComponentName;[Ljava/lang/String;Z)[Ljava/lang/String;", "GetSetPackagesSuspended_Landroid_content_ComponentName_arrayLjava_lang_String_ZHandler", ApiSince=24)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_PACKAGE_STATE")]
public virtual string[] SetPackagesSuspended (Android.Content.ComponentName? admin, string[] packageNames, bool suspended);

[<Android.Runtime.Register("setPackagesSuspended", "(Landroid/content/ComponentName;[Ljava/lang/String;Z)[Ljava/lang/String;", "GetSetPackagesSuspended_Landroid_content_ComponentName_arrayLjava_lang_String_ZHandler", ApiSince=24)>]
[<Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_PACKAGE_STATE")>]
abstract member SetPackagesSuspended : Android.Content.ComponentName * string[] * bool -> string[]
override this.SetPackagesSuspended : Android.Content.ComponentName * string[] * bool -> string[]

Parameters

admin: ComponentName

Which DeviceAdminReceiver this request is associated with. Null if the caller is not a device admin.

packageNames: String[]

The package names to suspend or unsuspend.

suspended: Boolean

If set to true than the packages will be suspended, if set to false the packages will be unsuspended.

Returns

String[]

an array of package names for which the suspended status is not set as requested in this method.

Attributes: RegisterAttribute RequiresPermissionAttribute

Remarks

Called by device or profile owners to suspend packages for this user. This function can be called by a device owner, profile owner, or by a delegate given the #DELEGATION_PACKAGE_ACCESS scope via #setDelegatedScopes.

A suspended package will not be able to start activities. Its notifications will be hidden, it will not show up in recents, will not be able to show toasts or dialogs or ring the device.

The package must already be installed. If the package is uninstalled while suspended the package will no longer be suspended. The admin can block this by using #setUninstallBlocked.

Some apps cannot be suspended, such as device admins, the active launcher, the required package installer, the required package uninstaller, the required package verifier, the default dialer, and the permission controller.

Java documentation for android.app.admin.DevicePolicyManager.setPackagesSuspended(android.content.ComponentName, java.lang.String[], boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to