Share via

Win32_EncryptableVolume 类的 Decrypt 方法

  • 项目

Win32_EncryptableVolume 类的 Decrypt 方法开始解密完全加密的卷，或恢复部分加密卷的解密。

暂停或正在进行解密时，此方法的行为与 ResumeConversion 相同。 当加密暂停或正在进行时，此方法将还原加密并开始解密。 解密完成后，将从系统中删除此卷上的所有密钥保护程序，并将该卷转换为标准 NTFS 文件系统。

注意

如果光盘是硬件加密的， Decrypt 方法会将带状态设置为“始终解锁”，删除所有关联的元数据，并将驱动器的安全 ID 归零。

 

语法

uint32 Decrypt();

参数

此方法没有任何参数。

返回值

类型： uint32

此方法返回以下代码之一，如果失败，则返回另一个错误代码。

此方法会立即返回。 如果卷已完全解密且不存在其他错误，则此方法返回 0。

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
卷已锁定。
FVE_E_AUTOUNLOCK_ENABLED
2150694953 (0x80310029)
无法解密此卷，因为用于自动解锁数据卷的密钥可用。
使用 ClearAllAutoUnlockKeys 删除这些密钥。

 

安全注意事项

调用 Decrypt 方法会使数据不受保护。

如果在使用此方法之前卷的保护状态为 1 (PROTECTION ON) ，则成功完成此方法会将保护状态更改为 0 (保护关闭) ，因为根据定义，部分加密的卷不受保护。

备注

如果卷尚未完全解密，运行 Decrypt 会导致 GetConversionStatus 指示解密正在进行，并显示保持加密的卷的百分比。

如果在运行此方法之前卷的保护状态为“打开”，则运行此方法会将保护状态更改为“关闭”，因为根据定义，部分加密的卷不受保护。

如果此方法在当前运行的操作系统卷上运行，并且此操作系统卷用于自动解锁数据卷 (请参阅方法 EnableAutoUnlock) 必须先调用 ClearAllAutoUnlockKeys 方法。

托管对象格式 (MOF) 文件包含 Windows Management Instrumentation (WMI) 类的定义。 MOF 文件未作为 Windows SDK 的一部分安装。 使用 服务器管理器添加关联角色时，它们安装在服务器上。 有关 MOF 文件的详细信息，请参阅 托管对象格式 (MOF) 。

要求

要求 值
最低受支持的客户端
 Windows Vista 企业版，Windows Vista 旗舰版 [仅限桌面应用]
最低受支持的服务器
 Windows Server 2008 [仅限桌面应用]
命名空间
 Root\CIMV2\Security\MicrosoftVolumeEncryption
标头
Infocard.h
MOF
Win32_encryptablevolume.mof

另请参阅

Win32_EncryptableVolume