Share via

Win32_EncryptableVolume 类的 ChangeExternalKey 方法

  • 项目

Win32_EncryptableVolume 类的 ChangeExternalKey 方法更改与加密卷关联的外部密钥。

语法

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

parameters

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_ACTIVATED
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