Share via

Win32_EncryptableVolume 類別的 UnlockWithExternalKey 方法

  • 發行項

Win32_EncryptableVolume類別的UnlockWithExternalKey方法會使用提供的外部索引鍵來存取資料磁片區的內容。

磁片區的加密金鑰必須使用 ProtectKeyWithExternalKey 方法，使用 「External Key」 類型的一或多個金鑰保護裝置來保護，才能使用此方法解除鎖定磁片區。

注意

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

 

語法

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_ACTI加值稅ED
2150694920 (0x80310008)
磁碟區上未啟用 BitLocker。 新增金鑰保護裝置以啟用 BitLocker。

 

備註

Managed 物件格式 (MOF) 檔案包含 Windows Management Instrumentation (WMI) 類別的定義。 MOF 檔案不會安裝為 Windows SDK 的一部分。 當您使用 伺服器管理員 新增相關聯的角色時，它們會安裝在伺服器上。 如需 MOF 檔案的詳細資訊，請參閱 Managed Object Format (MOF) 。

規格需求

需求 值
最低支援的用戶端
 Windows Vista Enterprise、Windows Vista Ultimate [僅限傳統型應用程式]
最低支援的伺服器
 Windows Server 2008 [僅限傳統型應用程式]
命名空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另請參閱

Win32_EncryptableVolume