Win32_EncryptableVolume 类的 ChangePassphrase 方法

Win32_EncryptableVolume 类的 ChangePassphrase 方法使用新的通行短语来获取新的派生密钥。 计算派生密钥后,将使用新的派生密钥来保护加密卷的主密钥。

语法

uint32 ChangePassphrase(
  [in]  string VolumeKeyProtectorID,
  [in]  string NewPassphrase,
  [out] string NewProtectorID
);

参数

VolumeKeyProtectorID [in]

类型: 字符串

用于管理加密卷密钥保护程序的唯一字符串标识符。

NewPassphrase [in]

类型: 字符串

一个指定通行短语的更新字符串。

NewProtectorID [out]

类型: 字符串

更新的唯一字符串标识符,用于管理加密卷密钥保护程序。

返回值

类型: uint32

此方法返回以下代码之一,如果失败,则返回另一个错误代码。

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
卷已被 BitLocker 驱动器加密锁定。 必须从控制面板解锁驱动器。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
未在卷上启用 BitLocker。 添加密钥保护程序以启用 BitLocker。
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
加密卷的控制块已由另一个线程更新。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
指定的密钥保护程序的类型不正确。
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
提供的更新密码不符合最小或最大长度要求。
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
更新后的密码不符合管理员在组策略中设置的复杂性要求。

 

要求

要求
最低受支持的客户端
Windows 7 企业版,Windows 7 旗舰版 [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 R2 [仅限桌面应用]
命名空间
Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

另请参阅

Win32_EncryptableVolume