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