DevicePolicyManager.SetStorageEncryption(ComponentName, Boolean) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
此成员已弃用。
[Android.Runtime.Register("setStorageEncryption", "(Landroid/content/ComponentName;Z)I", "GetSetStorageEncryption_Landroid_content_ComponentName_ZHandler")]
public virtual Android.App.Admin.EncryptionStatus SetStorageEncryption (Android.Content.ComponentName admin, bool encrypt);
[<Android.Runtime.Register("setStorageEncryption", "(Landroid/content/ComponentName;Z)I", "GetSetStorageEncryption_Landroid_content_ComponentName_ZHandler")>]
abstract member SetStorageEncryption : Android.Content.ComponentName * bool -> Android.App.Admin.EncryptionStatus
override this.SetStorageEncryption : Android.Content.ComponentName * bool -> Android.App.Admin.EncryptionStatus
参数
- admin
- ComponentName
DeviceAdminReceiver
此请求与此请求相关联。
- encrypt
- Boolean
如果请求加密,则为 false 以释放任何以前的请求
返回
新的总请求状态(对于所有活动管理员),或 DevicePolicyManager#ENCRYPTION_STATUS_UNSUPPORTED
为非系统用户调用。
将是其中 #ENCRYPTION_STATUS_UNSUPPORTED
之一, #ENCRYPTION_STATUS_INACTIVE
或 #ENCRYPTION_STATUS_ACTIVE
。 这是请求的值;用于 #getStorageEncryptionStatus()
查询实际设备状态。
- 属性
注解
此成员已弃用。 此方法实际上不会修改设备的存储加密。 它从未影响设备的加密状态。
由管理设备的应用程序调用,以请求对存储系统进行加密。 如果调用方位于辅助用户或托管配置文件上,则不执行任何操作。 <p> 当多个设备管理员尝试控制设备加密时,始终使用最安全的受支持设置。 如果任何设备管理员请求设备加密,则会启用它;相反,如果设备管理员尝试禁用设备加密,而另一个设备管理员已启用该设备加密,则禁用呼叫将失败(最常见的返回 #ENCRYPTION_STATUS_ACTIVE
)。 <p> 此策略控制安全(应用程序数据)存储区域的加密。 写入到其他存储区域的数据可能或可能未加密,此策略不需要或控制任何其他存储区域的加密。 有一个例外:如果是android.os.Environment#isExternalStorageEmulated()
true
,则必须将所返回的android.os.Environment#getExternalStorageDirectory()
目录写入加密存储区域中的磁盘。 <p> 重要说明:在某些设备上,无需用户创建设备 PIN 或密码即可加密存储。 在这种情况下,存储已加密,但加密密钥可能无法完全保护。 为了获得最大的安全性,管理员还应要求(并检查)模式、PIN 或密码。
本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。