通过

Win32_EncryptableVolume 类的 GetConversionStatus 方法

  • 项目

Win32_EncryptableVolume 类的 GetConversionStatus 方法指示卷上的加密或解密状态。

语法

uint32 GetConversionStatus(
  [out] uint32 ConversionStatus,
  [out] uint32 EncryptionPercentage,
  [out] uint32 EncryptionFlags,
  [out] uint32 WipingStatus,
  [out] uint32 WipingPercentage,
  [in]  uint32 PrecisionFactor
);

parameters

ConversionStatus [out]

类型： uint32

卷加密或解密状态。 这可以是以下值之一。

值 含义
FullyDecrypted
0
 对于标准硬盘驱动器 (HDD) ，卷已完全解密。
对于硬件加密硬盘驱动器 (EHDD) ，卷将永久解锁。
FullyEncrypted
1
 对于标准硬盘驱动器 (HDD) ，卷已完全加密。
对于硬件加密硬盘驱动器 (EHDD) ，卷不会永久解锁。
EncryptionInProgress
2
 卷已部分加密。
DecryptionInProgress
3
 卷已部分加密。
EncryptionPaused
4
 卷在加密过程中已暂停。 卷已部分加密。
DecryptionPaused
5
 卷在解密过程中已暂停。 卷已部分加密。

 

EncryptionPercentage [out]

类型： uint32

加密卷的百分比。 这是一个介于 0 到 100 之间（含 0 到 100）的整数。

由于数字舍入，加密百分比为 0 或 100 不一定表示磁盘已完全解密或完全加密。 始终使用 ConversionStatus 来确定磁盘实际上是完全解密还是完全加密。

EncryptionFlags [out]

类型： uint32

描述加密行为的标志。

32 位与当前定义的以下位的组合。

值 含义
0x00000001
 启动新的加密过程时，在仅数据加密模式下执行卷加密。 如果加密已暂停或停止，则调用 Encrypt 方法将有效地恢复转换，并忽略此位的值。 仅当 Encrypt 或 EncryptAfterHardwareTest 方法从完全解密状态开始加密、正在进行解密或解密暂停状态时，此位才有效。 如果此位为零，表示未设置，则在启动新的加密过程时，将执行全模式转换。
0x00000002
 对卷可用空间执行按需擦除。 仅当卷当前未转换或擦除且处于“加密”状态时，才允许使用此位集调用 Encrypt 方法。
0x00010000
 同步执行请求的操作。 调用将阻止，直到请求的操作已完成或中断。 只有 Encrypt 方法支持此标志。 当调用 Encrypt 以恢复停止或中断的加密或擦除时，或者加密或擦除正在进行时，可以指定此标志。 这允许调用方以同步方式继续等待进程完成或中断。

 

WipingStatus [out]

类型： uint32

可用空间擦除状态。 这可以是以下值之一。

值 含义
FreeSpaceNotWiped
0
 尚未擦除可用空间。
FreeSpaceWiped
1
 已擦除可用空间。
FreeSpaceWipingInProgress
2
 可用空间擦除目前正在进行中。
FreeSpaceWipingPaused
3
 已暂停可用空间擦除。

 

WipingPercentage [out]

类型： uint32

一个从 0 到 100 的值，指定已擦除的可用空间的百分比。

PrecisionFactor [in]

类型： uint32

一个从 0 到 4 的值，该值指定精度级别

返回值

类型： uint32

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

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
卷已锁定。

 

备注

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

要求

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

请参阅

Win32_EncryptableVolume