Win32_EncryptableVolume 類別的 UnlockWithCertificateThumbprint 方法

  • 發行項

Win32_EncryptableVolume類別的UnlockWithCertificateThumbprint方法會使用提供的憑證指紋來取得衍生的金鑰，並解除鎖定加密的磁片區。

注意

如果磁片支援硬體加密，此函式會將訊號區狀態設定為「已解除鎖定」

 

語法

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

參數

CertThumbprint [in]

類型： 字串

系統會接受指紋值為 0，並搜尋本機存放區以取得適當的憑證。 如果找到單一 BitLocker 憑證，搜尋就會成功。 如果找不到或多個憑證，方法就會失敗。

PIN [in]

類型： 字串

使用者指定的個人識別字串。 此字串必須包含 4 到 20 位數的序列。 此字串用於搭配智慧卡使用時，以無訊息方式驗證金鑰儲存提供者 (KSP) 。

傳回值

類型： uint32

此方法會在失敗時傳回下列其中一個代碼或另一個錯誤碼。

傳回碼/值 描述
S_OK
0 (0x0)
此方法成功。
FVE_E_NOT_ACTI加值稅ED
2150694920 (0x80310008)
磁碟區上未啟用 BitLocker。 新增金鑰保護裝置以啟用 BitLocker。
FVE_E_FAILED_AUTHENTICATION
2150694951 (0x80310027)
無法使用提供的資訊解除鎖定磁片區。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
提供的金鑰保護裝置不存在於磁片區上。 您必須輸入另一個金鑰保護裝置。
FVE_E_PRI加值稅EKEY_AUTH_FAILED
2150695060 (0x80310094)
無法授權與指定憑證相關聯的 私密金鑰 。 未提供私密金鑰授權，或提供的授權無效。

 

規格需求

需求 值
最低支援的用戶端
 Windows 7 企業版，Windows 7 旗艦版 [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 R2 [僅限桌面應用程式]
命名空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另請參閱

Win32_EncryptableVolume