DevicePolicyManager.LockNow Méthode

Définition

Espace de noms:: Android.App.Admin

Assembly:: Mono.Android.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
LockNow()	Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.
LockNow(DevicePolicyManagerFlags)	Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.

LockNow()

Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.

[Android.Runtime.Register("lockNow", "()V", "GetLockNowHandler")]
[Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")]
public virtual void LockNow();

[<Android.Runtime.Register("lockNow", "()V", "GetLockNowHandler")>]
[<Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")>]
abstract member LockNow : unit -> unit
override this.LockNow : unit -> unit

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.

Cette méthode sécurise l’appareil en réponse à une situation urgente, telle qu’un appareil perdu ou volé. Une fois cette méthode appelée, l’appareil doit être déverrouillé à l’aide d’une authentification forte (code confidentiel, modèle ou mot de passe). Cette API est destinée à être utilisée uniquement par les administrateurs de l’appareil.

À partir de la version android.os.Build.VERSION_CODES#R , l’appelant doit disposer de l’autorisation LOCK_DEVICE ou de l’appareil doit disposer de la fonctionnalité d’administrateur de l’appareil ; si aucune n’est vraie, la méthode retourne sans effectuer d’action. Avant la version android.os.Build.VERSION_CODES#R, l’appareil a besoin de la fonctionnalité d’administrateur de l’appareil, quelles que soient les autorisations de l’appelant.

L’administrateur de l’appareil appelant doit avoir demandé DeviceAdminInfo#USES_POLICY_FORCE_LOCK de pouvoir appeler cette méthode ; si ce n’est pas le cas, une exception de sécurité est levée.

Si aucun type de verrou n’est défini, cette méthode force l’appareil à passer en veille, mais ne verrouille pas l’appareil. Les administrateurs d’appareils qui trouvent l’appareil dans cet état peuvent verrouiller un appareil non sécurisé autrement en appelant #resetPassword d’abord pour définir le mot de passe, puis verrouiller l’appareil.

Cette méthode peut être appelée sur l’instance DevicePolicyManager retournée #getParentProfileInstance(ComponentName) pour verrouiller le profil parent.

REMARQUE : sur android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds, cette méthode ne désactive pas l’écran, car il s’agit d’une distraction de sécurité de conduite.

Équivaut à appeler #lockNow(int) sans indicateur.

Java documentation pour android.app.admin.DevicePolicyManager.lockNow().

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.

S’applique à

LockNow(DevicePolicyManagerFlags)

Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.

[Android.Runtime.Register("lockNow", "(I)V", "GetLockNow_IHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")]
public virtual void LockNow(Android.App.Admin.DevicePolicyManagerFlags flags);

[<Android.Runtime.Register("lockNow", "(I)V", "GetLockNow_IHandler", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.LOCK_DEVICE")>]
abstract member LockNow : Android.App.Admin.DevicePolicyManagerFlags -> unit
override this.LockNow : Android.App.Admin.DevicePolicyManagerFlags -> unit

Paramètres

flags: DevicePolicyManagerFlags

Peut être 0 ou #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY.

Attributs: RegisterAttribute RequiresPermissionAttribute

Remarques

Définissez immédiatement le verrouillage de l’appareil, comme si le délai d’expiration de l’écran de verrouillage a expiré au moment de cet appel.

Un administrateur d’appareil appelant doit avoir demandé DeviceAdminInfo#USES_POLICY_FORCE_LOCK à être en mesure d’appeler cette méthode ; si ce n’est pas le cas, une exception de sécurité sera levée.

Cette méthode peut être appelée sur l’instance DevicePolicyManager retournée #getParentProfileInstance(ComponentName) afin de verrouiller le profil parent ainsi que le profil managé.

REMARQUE : Pour verrouiller le profil parent et supprimer la clé de chiffrement du profil managé, #lockNow() doit être appelée deux fois : Tout d’abord, #lockNow() elle doit être appelée sur l’instance DevicePolicyManager retournée par #getParentProfileInstance(ComponentName), puis #lockNow(int) être appelée sur l’instance DevicePolicyManager associée au profil managé, avec l’indicateur #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY . L’appel de la méthode deux fois dans cet ordre garantit que tous les utilisateurs sont verrouillés et n’empêchent pas l’administrateur de l’appareil sur le profil managé d’émettre un deuxième appel pour verrouiller son propre profil.

REMARQUE : sur android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds, cette méthode ne désactive pas l’écran, car il s’agit d’une distraction de sécurité de conduite.

Java documentation pour android.app.admin.DevicePolicyManager.lockNow(int).

S’applique à