Win32_EncryptableVolume 类的 GetHardwareTestStatus 方法

Win32_EncryptableVolume 类的 GetHardwareTestStatus 方法提供有关完全解密操作系统卷的硬件测试的状态信息。

使用此方法可显示硬件测试是否挂起，以及在上次计算机重启时完成的硬件测试的成功或失败。 若要请求硬件测试，请使用 EncryptAfterHardwareTest 方法。

语法

uint32 GetHardwareTestStatus(
  [out] uint32 TestStatus,
  [out] uint32 TestError
);

参数

TestStatus [out]

类型： uint32

指定硬件测试是否处于挂起状态，以及在上次计算机重启时完成的硬件测试失败成功。

值	含义
NotFailed_and_NonePending 0	如果请求了测试，则表示在上次重启计算机时测试成功，并且卷加密正在进行中。 有关加密状态，请参阅 GetConversionStatus 方法。 否则，上次重启计算机时不会运行任何测试，并且没有测试处于挂起状态。
已失败 1	卷加密未启动。 已删除所有密钥保护程序。 若要解决失败的测试，请执行以下操作： 请参阅 TestError 参数中的信息。 添加密钥保护程序并再次使用 EncryptAfterHardwareTest 方法。
挂起 2	已请求测试，将在下一次计算机重启时运行。

 

TestError [out]

类型： uint32

指定上次完成的硬件测试中的错误。

值	含义
0	上次重启计算机时未发生任何错误或未运行硬件测试。
2150694972 (0x8031003C)	FVE_E_KEYFILE_NOT_FOUND 找不到具有外部密钥文件的 U 盘。 如果此故障仍然存在，则计算机在重启期间无法读取 U 盘。 在重启期间，可能无法使用外部密钥解锁操作系统卷。
2150694973 (0x8031003D)	FVE_E_KEYFILE_INVALID U 盘上的外部密钥文件已损坏。 尝试使用其他 U 盘来存储外部密钥文件。
2150694975 (0x8031003F)	FVE_E_TPM_DISABLED TPM 已禁用或已停用，或者同时禁用和停用。 若要打开 TPM，请使用 Win32_Tpm WMI 提供程序或运行 TPM 管理单元 (Tpm.msc) 。
2150694977 (0x80310041)	FVE_E_TPM_INVALID_PCR TPM 检测到当前平台验证配置文件中的操作系统重启服务发生了更改。 从计算机中删除任何启动 CD 或 DVD。 如果此故障仍然存在，检查已安装最新的固件和 BIOS 升级，并且 TPM 在其他方面正常工作。
2150694979 (0x80310043)	FVE_E_PIN_INVALID 提供的 PIN 不正确。

 

返回值

类型： uint32

下表列出了一些常见的返回代码。

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

 

备注

若要请求硬件测试，请使用 EncryptAfterHardwareTest 方法。

若要在状态为“挂起”时运行硬件测试，请执行以下步骤：

1. 将包含外部密钥文件的 U 盘插入计算机。 仅当卷具有类型为“外部密钥”或“TPM 和启动密钥”的密钥保护器时，此步骤才适用。
2. 重新启动计算机。 重启计算机时，硬件测试会自动运行。

若要取消硬件测试，请使用 Encrypt 方法。

成功的测试确定：

• 如果存在与 TPM 相关的密钥保护程序，则 TPM 可以解锁卷。
• 如果卷可以通过外部密钥解锁， (包括启动密钥) ，计算机可以在启动期间读取包含外部密钥文件的 U 盘。

在转换进行任何更改后或下次重启计算机后，硬件测试结果将不可用。 检查系统事件日志中有关以前在计算机上运行的任何硬件测试的信息。

托管对象格式 (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