DeviceAdminReceiver Class
Definition
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.
Base class for implementing a device administration component.
[Android.Runtime.Register("android/app/admin/DeviceAdminReceiver", DoNotGenerateAcw=true)]
public class DeviceAdminReceiver : Android.Content.BroadcastReceiver[<Android.Runtime.Register("android/app/admin/DeviceAdminReceiver", DoNotGenerateAcw=true)>]
type DeviceAdminReceiver = class
inherit BroadcastReceiver- Inheritance
- Attributes
Remarks
Base class for implementing a device administration component. This class provides a convenience for interpreting the raw intent actions that are sent by the system.
The callback methods, like the base BroadcastReceiver#onReceive(Context, Intent) BroadcastReceiver.onReceive() method, happen on the main thread of the process. Thus long running operations must be done on another thread. Note that because a receiver is done once returning from its receive function, such long-running operations should probably be done in a Service.
When publishing your DeviceAdmin subclass as a receiver, it must handle #ACTION_DEVICE_ADMIN_ENABLED and require the android.Manifest.permission#BIND_DEVICE_ADMIN permission. A typical manifest entry would look like:
{
Java documentation for android.app.admin.DeviceAdminReceiver.
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.
Constructors
| DeviceAdminReceiver() | |
| DeviceAdminReceiver(IntPtr, JniHandleOwnership) |
A constructor used when creating managed representations of JNI objects; called by the runtime. |
Fields
| ActionChoosePrivateKeyAlias |
Broadcast action: notify that some app is attempting to choose a KeyChain key. |
| ActionDeviceAdminDisabled |
Action sent to a device administrator when the user has disabled it. |
| ActionDeviceAdminDisableRequested |
Action sent to a device administrator when the user has requested to disable it, but before this has actually been done. |
| ActionDeviceAdminEnabled |
This is the primary action that a device administrator must implement to be allowed to manage a device. |
| ActionLockTaskEntering |
Action sent to a device administrator to notify that the device is entering lock task mode. |
| ActionLockTaskExiting |
Action sent to a device administrator to notify that the device is exiting lock task mode. |
| ActionNetworkLogsAvailable |
Broadcast action: notify that a new batch of network logs is ready to be collected. |
| ActionPasswordChanged |
Action sent to a device administrator when the user has changed the password of their device or profile challenge. |
| ActionPasswordExpiring |
Action periodically sent to a device administrator when the device or profile challenge password is expiring. |
| ActionPasswordFailed |
Action sent to a device administrator when the user has entered an incorrect device or profile challenge password. |
| ActionPasswordSucceeded |
Action sent to a device administrator when the user has successfully entered their device or profile challenge password, after failing one or more times. |
| ActionProfileProvisioningComplete |
Broadcast Action: This broadcast is sent to indicate that provisioning of a managed profile or managed device has completed successfully. |
| ActionSecurityLogsAvailable |
Broadcast action: notify that a new batch of security logs is ready to be collected. |
| BugreportFailureFailedCompleting |
Obsolete.
Bugreport completion process failed. |
| BugreportFailureFileNoLongerAvailable |
Obsolete.
Bugreport has been created, but is no longer available for collection. |
| DeviceAdminMetaData |
Name under which a DevicePolicy component publishes information about itself. |
| ExtraDisableWarning |
A CharSequence that can be shown to the user informing them of the impact of disabling your admin. |
| ExtraLockTaskPackage |
A string containing the name of the package entering lock task mode. |
| ExtraTransferOwnershipAdminExtrasBundle |
A |
Properties
| AbortBroadcast |
Returns the flag indicating whether or not this receiver should abort the current broadcast. (Inherited from BroadcastReceiver) |
| Class |
Returns the runtime class of this |
| DebugUnregister |
Return the last value given to |
| Handle |
The handle to the underlying Android instance. (Inherited from Object) |
| IsInitialStickyBroadcast |
Returns true if the receiver is currently processing the initial value of a sticky broadcast -- that is, the value that was last broadcast and is currently held in the sticky cache, so this is not directly the result of a broadcast right now. (Inherited from BroadcastReceiver) |
| IsOrderedBroadcast |
Returns true if the receiver is currently processing an ordered broadcast. (Inherited from BroadcastReceiver) |
| JniIdentityHashCode | (Inherited from Object) |
| JniPeerMembers | |
| PeerReference | (Inherited from Object) |
| ResultCode |
Retrieve the current result code, as set by the previous receiver. -or- Change the current result code of this broadcast; only works with
broadcasts sent through
|
| ResultData |
Retrieve the current result data, as set by the previous receiver. -or- Change the current result data of this broadcast; only works with
broadcasts sent through
|
| SentFromPackage |
Returns the package name of the app that initially sent this broadcast. (Inherited from BroadcastReceiver) |
| SentFromUid |
Returns the uid of the app that initially sent this broadcast. (Inherited from BroadcastReceiver) |
| ThresholdClass |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
| ThresholdType |
This API supports the Mono for Android infrastructure and is not intended to be used directly from your code. |
Methods
| ClearAbortBroadcast() |
Clears the flag indicating that this receiver should abort the current broadcast. (Inherited from BroadcastReceiver) |
| Clone() |
Creates and returns a copy of this object. (Inherited from Object) |
| Dispose() | (Inherited from Object) |
| Dispose(Boolean) | (Inherited from Object) |
| Equals(Object) |
Indicates whether some other object is "equal to" this one. (Inherited from Object) |
| GetHashCode() |
Returns a hash code value for the object. (Inherited from Object) |
| GetManager(Context) |
Retrieve the DevicePolicyManager interface for this administrator to work with the system. |
| GetResultExtras(Boolean) |
Retrieve the current result extra data, as set by the previous receiver. (Inherited from BroadcastReceiver) |
| GetWho(Context) |
Retrieve the ComponentName describing who this device administrator is, for
use in |
| GoAsync() |
This can be called by an application in |
| InvokeAbortBroadcast() |
Sets the flag indicating that this receiver should abort the
current broadcast; only works with broadcasts sent through
|
| JavaFinalize() |
Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. (Inherited from Object) |
| Notify() |
Wakes up a single thread that is waiting on this object's monitor. (Inherited from Object) |
| NotifyAll() |
Wakes up all threads that are waiting on this object's monitor. (Inherited from Object) |
| OnBugreportFailed(Context, Intent, BugReportFailureReason) |
Called when the bugreport collection flow has failed. |
| OnBugreportShared(Context, Intent, String) |
Called when the bugreport has been shared with the device administrator app. |
| OnBugreportSharingDeclined(Context, Intent) |
Called when sharing a bugreport has been cancelled by the user of the device. |
| OnChoosePrivateKeyAlias(Context, Intent, Int32, Uri, String) |
Allows this receiver to select the alias for a private key and certificate pair for authentication. |
| OnComplianceAcknowledgementRequired(Context, Intent) |
Called to notify a profile owner of an organization-owned device that it needs to acknowledge device compliance to allow the user to turn the profile off if needed according to the maximum profile time off policy. |
| OnDisabled(Context, Intent) |
Called prior to the administrator being disabled, as a result of
receiving |
| OnDisableRequested(Context, Intent) |
Called when the user has asked to disable the administrator, as a result of
receiving |
| OnDisableRequestedFormatted(Context, Intent) |
Called when the user has asked to disable the administrator, as a result of
receiving |
| OnEnabled(Context, Intent) |
Called after the administrator is first enabled, as a result of
receiving |
| OnLockTaskModeEntering(Context, Intent, String) |
Called when a device is entering lock task mode. |
| OnLockTaskModeExiting(Context, Intent) |
Called when a device is exiting lock task mode. |
| OnNetworkLogsAvailable(Context, Intent, Int64, Int32) |
Called each time a new batch of network logs can be retrieved. |
| OnOperationSafetyStateChanged(Context, Int32, Boolean) |
Called to notify the state of operations that can be unsafe to execute has changed. |
| OnPasswordChanged(Context, Intent, UserHandle) |
Called after the user has changed their device or profile challenge password, as a result of
receiving |
| OnPasswordChanged(Context, Intent) |
Called after the user has changed their device or profile challenge password, as a result of
receiving |
| OnPasswordExpiring(Context, Intent, UserHandle) |
Called periodically when the device or profile challenge password is about to expire or has expired. |
| OnPasswordExpiring(Context, Intent) |
Called periodically when the device or profile challenge password is about to expire or has expired. |
| OnPasswordFailed(Context, Intent, UserHandle) |
Called after the user has failed at entering their device or profile challenge password,
as a result of receiving |
| OnPasswordFailed(Context, Intent) |
Called after the user has failed at entering their device or profile challenge password,
as a result of receiving |
| OnPasswordSucceeded(Context, Intent, UserHandle) |
Called after the user has succeeded at entering their device or profile challenge password,
as a result of receiving |
| OnPasswordSucceeded(Context, Intent) |
Called after the user has succeeded at entering their device or profile challenge password,
as a result of receiving |
| OnProfileProvisioningComplete(Context, Intent) |
Called when provisioning of a managed profile or managed device has completed successfully. |
| OnReadyForUserInitialization(Context, Intent) |
Called during provisioning of a managed device to allow the device initializer to perform user setup steps. |
| OnReceive(Context, Intent) |
Intercept standard device administrator broadcasts. |
| OnSecurityLogsAvailable(Context, Intent) |
Called when a new batch of security logs can be retrieved. |
| OnSystemUpdatePending(Context, Intent, Int64) |
Called when the information about a pending system update is available. |
| OnTransferAffiliatedProfileOwnershipComplete(Context, UserHandle) |
Called on the device owner when the ownership of one of its affiliated profiles is transferred. |
| OnTransferOwnershipComplete(Context, PersistableBundle) |
Called on the newly assigned owner (either device owner or profile owner) when the ownership transfer has completed successfully. |
| OnUserAdded(Context, Intent, UserHandle) |
Called when a user or profile is created. |
| OnUserRemoved(Context, Intent, UserHandle) |
Called when a user or profile is removed. |
| OnUserStarted(Context, Intent, UserHandle) |
Called when a user or profile is started. |
| OnUserStopped(Context, Intent, UserHandle) |
Called when a user or profile is stopped. |
| OnUserSwitched(Context, Intent, UserHandle) |
Called when a user or profile is switched to. |
| PeekService(Context, Intent) |
Provide a binder to an already-bound service. (Inherited from BroadcastReceiver) |
| SetHandle(IntPtr, JniHandleOwnership) |
Sets the Handle property. (Inherited from Object) |
| SetOrderedHint(Boolean) |
For internal use, sets the hint about whether this BroadcastReceiver is running in ordered mode. (Inherited from BroadcastReceiver) |
| SetResult(Result, String, Bundle) |
Change all of the result data returned from this broadcasts; only works
with broadcasts sent through
|
| SetResultExtras(Bundle) |
Change the current result extras of this broadcast; only works with
broadcasts sent through
|
| ToArray<T>() | (Inherited from Object) |
| ToString() |
Returns a string representation of the object. (Inherited from Object) |
| UnregisterFromRuntime() | (Inherited from Object) |
| Wait() |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>. (Inherited from Object) |
| Wait(Int64, Int32) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
| Wait(Int64) |
Causes the current thread to wait until it is awakened, typically by being <em>notified</em> or <em>interrupted</em>, or until a certain amount of real time has elapsed. (Inherited from Object) |
Explicit Interface Implementations
| IJavaPeerable.Disposed() | (Inherited from Object) |
| IJavaPeerable.DisposeUnlessReferenced() | (Inherited from Object) |
| IJavaPeerable.Finalized() | (Inherited from Object) |
| IJavaPeerable.JniManagedPeerState | (Inherited from Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) | (Inherited from Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) | (Inherited from Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) | (Inherited from Object) |
Extension Methods
| JavaCast<TResult>(IJavaObject) |
Performs an Android runtime-checked type conversion. |
| JavaCast<TResult>(IJavaObject) | |
| GetJniTypeName(IJavaPeerable) | |