Win32_EncryptableVolume 类的 UnlockWithExternalKey 方法

  • 项目

Win32_EncryptableVolume 类的 UnlockWithExternalKey 方法使用提供的外部密钥来访问数据卷的内容。

卷的加密密钥必须已使用 ProtectKeyWithExternalKey 方法的一个或多个类型为“外部密钥”的密钥保护程序进行保护，才能使用此方法解锁卷。

注意

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

 

语法

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

参数

ExternalKey [in]

类型： uint8[]

字节数组，指定用于解锁卷的 256 位外部密钥。 可以通过调用 GetExternalKeyFromFile 方法获取此密钥。

返回值

类型： uint32

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

如果卷已解锁，此方法返回 0。

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
ERROR_NOT_FOUND
没有给定 (0x) 的值
 卷没有类型为“外部密钥”的密钥保护程序。
ERROR_INVALID_PASSWORD
没有给定 (0x) 的值
 存在一个或多个“外部密钥”类型的密钥保护程序，但指定的 ExternalKey 参数无法解锁卷。
E_INVALIDARG
2147942487 (0x80070057)
ExternalKey 参数不是大小为 4 的数组。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
未在卷上启用 BitLocker。 添加密钥保护程序以启用 BitLocker。

 

备注

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