Share via


PolicyUpdateReceiver Class

Definition

Base class for implementing a policy update receiver.

[Android.Runtime.Register("android/app/admin/PolicyUpdateReceiver", ApiSince=34, DoNotGenerateAcw=true)]
public abstract class PolicyUpdateReceiver : Android.Content.BroadcastReceiver
[<Android.Runtime.Register("android/app/admin/PolicyUpdateReceiver", ApiSince=34, DoNotGenerateAcw=true)>]
type PolicyUpdateReceiver = class
    inherit BroadcastReceiver
Inheritance
PolicyUpdateReceiver
Attributes

Remarks

Base class for implementing a policy update receiver. This class provides a convenience for interpreting the raw intent actions (#ACTION_DEVICE_POLICY_SET_RESULT and #ACTION_DEVICE_POLICY_CHANGED) that are sent by the system.

The callback methods happen on the main thread of the process. Thus, long-running operations must be done on another thread.

When publishing your PolicyUpdateReceiver subclass as a receiver, it must require the android.Manifest.permission#BIND_DEVICE_ADMIN permission.

Admins can implement DeviceAdminService to ensure they receive all policy updates (for policies they have set) via #onPolicyChanged by constantly being bound to by the system. For more information see DeviceAdminService.

Java documentation for android.app.admin.PolicyUpdateReceiver.

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

PolicyUpdateReceiver()
PolicyUpdateReceiver(IntPtr, JniHandleOwnership)

Fields

ActionDevicePolicyChanged

Action for a broadcast sent to admins to communicate back a change in a policy they have previously set.

ActionDevicePolicySetResult

Action for a broadcast sent to admins to communicate back the result of setting a policy in DevicePolicyManager.

ExtraAccountType

A string extra holding the account type this policy applies to, (see PolicyUpdateReceiver#onPolicyChanged and PolicyUpdateReceiver#onPolicySetResult)

ExtraIntentFilter

An android.content.IntentFilter extra holding the intent filter the policy relates to, (see PolicyUpdateReceiver#onPolicyChanged and PolicyUpdateReceiver#onPolicySetResult)

ExtraPackageName

A string extra holding the package name the policy applies to, (see PolicyUpdateReceiver#onPolicyChanged and PolicyUpdateReceiver#onPolicySetResult)

ExtraPermissionName

A string extra holding the permission name the policy applies to, (see PolicyUpdateReceiver#onPolicyChanged and PolicyUpdateReceiver#onPolicySetResult)

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 Object.

(Inherited from Object)
DebugUnregister

Return the last value given to #setDebugUnregister. -or- Control inclusion of debugging help for mismatched calls to Context#registerReceiver(BroadcastReceiver, IntentFilter) Context.registerReceiver().

(Inherited from BroadcastReceiver)
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 Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast.

(Inherited from BroadcastReceiver)
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 Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast.

(Inherited from BroadcastReceiver)
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
ThresholdType

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)
GetResultExtras(Boolean)

Retrieve the current result extra data, as set by the previous receiver.

(Inherited from BroadcastReceiver)
GoAsync()

This can be called by an application in #onReceive to allow it to keep the broadcast active after returning from that function.

(Inherited from BroadcastReceiver)
InvokeAbortBroadcast()

Sets the flag indicating that this receiver should abort the current broadcast; only works with broadcasts sent through Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast.

(Inherited from BroadcastReceiver)
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)
OnPolicyChanged(Context, String, Bundle, TargetUser, PolicyUpdateResult)

Callback triggered when a policy previously set by the admin has changed.

OnPolicySetResult(Context, String, Bundle, TargetUser, PolicyUpdateResult)

Callback triggered after an admin has set a policy using one of the APIs in DevicePolicyManager to notify the admin whether it has been successful or not.

OnReceive(Context, Intent)

Intercept standard policy update broadcasts.

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 Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast.

(Inherited from BroadcastReceiver)
SetResultExtras(Bundle)

Change the current result extras of this broadcast; only works with broadcasts sent through Context#sendOrderedBroadcast(Intent, String) Context.sendOrderedBroadcast.

(Inherited from BroadcastReceiver)
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)

Applies to