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