Share via

Win32_EncryptableVolume 类的 UnlockWithCertificateThumbprint 方法

  • 项目

Win32_EncryptableVolume 类的 UnlockWithCertificateThumbprint 方法使用提供的证书指纹获取派生密钥并解锁加密卷。

注意

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

 

语法

uint32 UnlockWithCertificateThumbprint(
  [in] string CertThumbprint,
  [in] string PIN
);

parameters

CertThumbprint [in]

类型： 字符串

指纹值 0 将被接受，并导致在本地存储中搜索相应的证书。 如果找到单个 BitLocker 证书，则搜索成功。 如果找不到任何证书或多个证书，该方法将失败。

PIN [in]

类型： 字符串

用户指定的个人标识字符串。 此字符串必须包含 4 到 20 位数字的序列。 此字符串用于在与智能卡一起使用时， (KSP) 以无提示方式对密钥存储提供程序进行身份验证。

返回值

类型： uint32

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

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
未在卷上启用 BitLocker。 添加密钥保护程序以启用 BitLocker。
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
无法使用提供的信息解锁卷。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
卷上不存在提供的密钥保护程序。 必须输入另一个密钥保护程序。
FVE_E_PRIVATEKEY_AUTH_FAILED
2150695060 (0x80310094)
无法授权与指定证书关联的 私钥 。 未提供私钥授权或提供的授权无效。

 

要求

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

请参阅

Win32_EncryptableVolume