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