DevicePolicyManager.LockNow メソッド

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

[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.MANAGE_DEVICE_POLICY_LOCK")>]
abstract member LockNow : unit -> unit
override this.LockNow : unit -> unit

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

属性

RegisterAttribute RequiresPermissionAttribute

注釈

この呼び出しの時点でロック画面のタイムアウトが切れているかのように、デバイスをすぐにロックします。

この方法では、デバイスの紛失や盗難など、緊急の状況に対応してデバイスをセキュリティで保護します。 このメソッドを呼び出した後、強力な認証 (PIN、パターン、またはパスワード) を使用してデバイスのロックを解除する必要があります。 この API は、デバイス管理者のみが使用することを目的としています。

バージョン android.os.Build.VERSION_CODES#R 以降では、呼び出し元はLOCK_DEVICEアクセス許可を持っているか、デバイスにデバイス管理機能が必要です。どちらも true でない場合、メソッドはアクションを完了せずに戻ります。 バージョン android.os.Build.VERSION_CODES#R前は、呼び出し元のアクセス許可に関係なく、デバイスにはデバイス管理機能が必要です。

呼び出し元のデバイス管理者は、このメソッドを呼び出すことができるように DeviceAdminInfo#USES_POLICY_FORCE_LOCK を要求している必要があります。呼び出していない場合は、セキュリティ例外がスローされます。

ロックの種類が設定されていない場合、このメソッドはデバイスを強制的にスリープ状態にしますが、デバイスをロックしません。 この状態のデバイスを見つけたデバイス管理者は、最初に #resetPassword を呼び出してパスワードを設定してからデバイスをロックすることで、セキュリティで保護されていないデバイスをロックできます。

このメソッドは、親プロファイルをロックするために、#getParentProfileInstance(ComponentName)によって返されるDevicePolicyManager インスタンスで呼び出すことができます。

注: android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive buildsでは、この方法は運転安全の邪魔になるので、画面をオフにしません。

フラグなしで #lockNow(int) を呼び出すことと同じです。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

[Android.Runtime.Register("lockNow", "(I)V", "GetLockNow_IHandler", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.MANAGE_DEVICE_POLICY_LOCK")]
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")]
public virtual void LockNow(Android.App.Admin.DevicePolicyManagerFlags flags);

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

[<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

パラメーター

属性

RegisterAttribute RequiresPermissionAttribute

注釈

この呼び出しの時点でロック画面のタイムアウトが切れているかのように、デバイスをすぐにロックします。

この方法では、デバイスの紛失や盗難など、緊急の状況に対応してデバイスをセキュリティで保護します。 このメソッドを呼び出した後、強力な認証 (PIN、パターン、またはパスワード) を使用してデバイスのロックを解除する必要があります。 この API は、デバイス管理者のみが使用することを目的としています。

バージョン android.os.Build.VERSION_CODES#R 以降では、呼び出し元はLOCK_DEVICEアクセス許可を持っているか、デバイスにデバイス管理機能が必要です。どちらも true でない場合、メソッドはアクションを完了せずに戻ります。 バージョン android.os.Build.VERSION_CODES#R前は、呼び出し元のアクセス許可に関係なく、デバイスにはデバイス管理機能が必要です。

呼び出し元のデバイス管理者は、このメソッドを呼び出すことができるように DeviceAdminInfo#USES_POLICY_FORCE_LOCK を要求している必要があります。呼び出していない場合は、セキュリティ例外がスローされます。

ロックの種類が設定されていない場合、このメソッドはデバイスを強制的にスリープ状態にしますが、デバイスをロックしません。 この状態のデバイスを見つけたデバイス管理者は、最初に #resetPassword を呼び出してパスワードを設定してからデバイスをロックすることで、セキュリティで保護されていないデバイスをロックできます。

このメソッドは、親プロファイルとマネージド プロファイルをロックするために、#getParentProfileInstance(ComponentName)によって返されるDevicePolicyManager インスタンスで呼び出すことができます。

注: 親プロファイルをロックしてマネージド プロファイルの暗号化キーを削除するには、#lockNow()を 2 回呼び出す必要があります。最初に、#getParentProfileInstance(ComponentName)によって返されたDevicePolicyManager インスタンスに対して#lockNow()を呼び出してから、#FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY フラグを使用して、マネージド プロファイルに関連付けられているDevicePolicyManager インスタンスで#lockNow(int)呼び出す必要があります。 この順序でメソッドを 2 回呼び出すと、すべてのユーザーがロックされ、管理対象プロファイルのデバイス管理者が独自のプロファイルをロックするための 2 回目の呼び出しを発行できなくなります。

注: android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive buildsでは、この方法は運転安全の邪魔になるので、画面をオフにしません。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。