Share via

Win32_EncryptableVolume 類別的 ChangeExternalKey 方法

  • 發行項

Win32_EncryptableVolume類別的ChangeExternalKey方法會變更與加密磁片區相關聯的外部金鑰。

語法

uint32 ChangeExternalKey(
  [in]           string VolumeKeyProtectorID,
  [in, optional] uint8   NewExternalKey[],
  [out]          string NewVolumeKeyProtectorID
);

參數

VolumeKeyProtectorID [in]

類型： 字串

用來管理加密磁片區金鑰保護裝置的唯一字串識別碼。

NewExternalKey [in， optional]

類型： uint8[]

位元組陣列，指定用來解除鎖定磁片區的 256 位外部金鑰。

NewVolumeKeyProtectorID [out]

類型： 字串

用來管理加密磁片區金鑰保護裝置的更新唯一字串識別碼。

傳回值

類型： uint32

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

傳回碼/值 描述
S_OK
0 (0x0)
此方法成功。
E_INVALIDARG
2147942487 (0x80070057)
NewExternalKey參數不是大小為 32 的陣列。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
磁片區已鎖定。
FVE_E_NOT_ACTI加值稅ED
2150694920 (0x80310008)
磁碟區上未啟用 BitLocker。 新增金鑰保護裝置以啟用 BitLocker。
FVE_E_BOOTABLE_CDDVD
2150694960 (0x80310030)
在此電腦中找到可開機的 CD/DVD。 移除 CD/DVD，然後重新開機電腦。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
提供的金鑰保護裝置不存在於磁片區上。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
VolumeKeyProtectorID參數不會參考類型為「數值密碼」或「外部金鑰」的金鑰保護裝置。 使用 ProtectKeyWithNumericalPassword 或 ProtectKeyWithExternalKey 方法來建立適當類型的金鑰保護裝置。

 

備註

這個方法可以用來變更任何使用外部金鑰的金鑰保護裝置的外部金鑰。

規格需求

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

另請參閱

Win32_EncryptableVolume