Share via

Win32_EncryptableVolume 类的 UnlockWithNumericalPassword 方法

  • 项目

Win32_EncryptableVolume 类的 UnlockWithNumericalPassword 方法使用提供的数字密码访问数据卷的内容。

卷的加密密钥必须已通过一个或多个类型为“数字密码” (的密钥保护程序进行保护，方法是使用 ProtectKeyWithNumericalPassword 方法) 才能使用此方法解锁卷。

注意

如果光盘支持硬件加密，则此函数将带状态设置为“已解锁”

 

语法

uint32 UnlockWithNumericalPassword(
  [in] string NumericalPassword
);

参数

NumericalPassword [in]

类型： 字符串

一个指定数字密码的字符串。

数字密码必须包含 48 位数字。 这些数字可划分为 8 组（6 位数字），每个组中的最后一位数字表示该组的校验和值。 每组 6 位数字必须可被 11 整除，并且必须小于 65536。 假设一组 6 位数字标记为 x1、x2、x3、x4、x5 和 x6，则校验和 x6 数字的计算方式为 –x1+x2–x3+x4–x5 mod 11。

可以选择用空格或连字符分隔数字组。 因此，“xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxx-xxxxxxxxx”或“xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx xxxxxx”也可能包含有效的数字密码。

返回值

类型： uint32

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

如果卷已解锁且未发生其他错误，则此方法返回 0。

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
未在卷上启用 BitLocker。 添加密钥保护程序以启用 BitLocker。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
卷没有“数字密码”类型的密钥保护程序。
NumericalPassword 参数的格式有效，但不能使用数字密码来解锁卷。
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
NumericalPassword 参数无法解锁卷。
存在一个或多个“数字密码”类型的密钥保护程序，但指定的 NumericalPassword 参数无法解锁卷。
FVE_E_INVALID_PASSWORD_FORMAT
2150694965 (0x80310035)
NumericalPassword 参数没有有效的格式。

 

备注

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