DevicePolicyManager.LockNow メソッド

  • リファレンス

定義

名前空間:
Android.App.Admin
アセンブリ:
Mono.Android.dll

オーバーロード

LockNow()

この呼び出しの時点でロック画面のタイムアウトが期限切れになったかのように、デバイスをすぐにロックします。
LockNow(DevicePolicyManagerFlags)

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

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.MANAGE_DEVICE_POLICY_LOCK")>]
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 してパスワードを設定してからデバイスをロックすることで、それ以外の安全でないデバイスをロックできます。

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

注: の場合 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds、この方法では、運転安全上の注意が散らばる可能性があるため、画面はオフになりません。

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

の Java ドキュメント android.app.admin.DevicePolicyManager.lockNow()。

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

適用対象

LockNow(DevicePolicyManagerFlags)

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

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

パラメーター

flags
DevicePolicyManagerFlags

0 または #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEYを指定できます。

属性
RegisterAttribute RequiresPermissionAttribute

注釈

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

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

バージョン 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 を呼び出してから、 #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY#lockNow() フラグを指定して#lockNow(int)、マネージド プロファイルに関連付けられているインスタンスで DevicePolicyManager を呼び出す必要があります。 メソッドをこの順序で 2 回呼び出すと、すべてのユーザーがロックされ、管理対象プロファイルのデバイス管理者が独自のプロファイルをロックするための 2 回目の呼び出しを発行できなくなります。

注: の場合 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds、この方法では、運転安全上の注意が散らばる可能性があるため、画面はオフになりません。

の Java ドキュメント android.app.admin.DevicePolicyManager.lockNow(int)。

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

適用対象