語言

DevicePolicyManager.LockNow 方法

定義

命名空間:
Android.App.Admin
組件:
Mono.Android.dll

多載

名稱 Description
LockNow()

立即讓裝置鎖定，就像鎖定畫面逾時在通話時已經過了一樣。
LockNow(DevicePolicyManagerFlags)

立即讓裝置鎖定，就像鎖定畫面逾時在通話時已經過了一樣。

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.LOCK_DEVICE")>]
abstract member LockNow : unit -> unit
override this.LockNow : unit -> unit
屬性
RegisterAttribute RequiresPermissionAttribute

備註

立即讓裝置鎖定，就像鎖定畫面逾時在通話時已經過了一樣。

此方法能在緊急狀況（如裝置遺失或被竊）時保護裝置。 此方法被呼叫後，必須使用強認證（PIN、模式或密碼）解鎖裝置。 此 API 僅供裝置管理員使用。

從版本 android.os.Build.VERSION_CODES#R 起，呼叫者必須擁有LOCK_DEVICE權限，或裝置必須具備裝置管理功能;若兩者皆不成立，則方法將返回且未完成任何操作。 在 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.app.admin.DevicePolicyManager.lockNow()。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於

LockNow(DevicePolicyManagerFlags)

立即讓裝置鎖定，就像鎖定畫面逾時在通話時已經過了一樣。

[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

參數

flags
DevicePolicyManagerFlags

可能是 0 或 #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY。

屬性
RegisterAttribute RequiresPermissionAttribute

備註

立即讓裝置鎖定，就像鎖定畫面逾時在通話時已經過了一樣。

此方法能在緊急狀況（如裝置遺失或被竊）時保護裝置。 此方法被呼叫後，必須使用強認證（PIN、模式或密碼）解鎖裝置。 此 API 僅供裝置管理員使用。

從版本 android.os.Build.VERSION_CODES#R 起，呼叫者必須擁有LOCK_DEVICE權限，或裝置必須具備裝置管理功能;若兩者皆不成立，則方法將返回且未完成任何操作。 在 android.os.Build.VERSION_CODES#R版本之前，裝置需要裝置管理員功能，不論呼叫者的權限如何。

呼叫裝置管理員必須有請求 DeviceAdminInfo#USES_POLICY_FORCE_LOCK 能夠呼叫此方法;若未請求，則會拋出安全例外。

如果沒有設定鎖定類型，這種方法會強制裝置進入睡眠，但不會鎖定裝置。 發現裝置處於此狀態的裝置管理員，可先打電話 #resetPassword 設定密碼，然後鎖定原本不安全的裝置。

此方法可在回傳#getParentProfileInstance(ComponentName)的實例上呼叫DevicePolicyManager，以鎖定父設定檔及受管理設定檔。

注意：為了鎖定父設定檔並驅逐受管理設定檔的加密金鑰， #lockNow() 必須呼叫兩次：首先 #lockNow() ，應在 DevicePolicyManager 由 返回 #getParentProfileInstance(ComponentName)的實例中呼叫，接著 #lockNow(int) 在與受管理配置檔相關聯的實例中呼叫 DevicePolicyManager ，並使用旗 #FLAG_EVICT_CREDENTIAL_ENCRYPTION_KEY 標。 依此順序呼叫該方法兩次，確保所有使用者都被鎖定，且不會阻止受管理設定檔的裝置管理員發出第二次呼叫來鎖定自己的設定檔。

注意：在 android.content.pm.PackageManager#FEATURE_AUTOMOTIVE automotive builds，這個方法不會關閉螢幕，因為會分散駕駛安全注意力。

Java 文件 android.app.admin.DevicePolicyManager.lockNow(int)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於