通过

Win32_EncryptableVolume 类的 ProtectKeyWithPassphrase 方法

  • 项目

Win32_EncryptableVolume 类的 ProtectKeyWithPassphrase 方法使用通行短语获取派生密钥。 计算派生密钥后，派生密钥用于保护加密卷的主密钥。

语法

uint32 ProtectKeyWithPassphrase(
  [in, optional] string FriendlyName,
  [in]           string Passphrase,
  [out]          string VolumeKeyProtectorID
);

parameters

FriendlyName [in， optional]

类型： 字符串

一个字符串，指定此密钥保护程序的用户分配的字符串标识符。 如果未指定此参数，则使用空白值。

通行短语 [in]

类型： 字符串

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

VolumeKeyProtectorID [out]

类型： 字符串

唯一标识创建的密钥保护程序的字符串。

如果驱动器支持硬件加密，并且 BitLocker 尚未获取带所有权，则 ID 字符串设置为“BitLocker”，并将密钥保护程序写入每个带元数据。

返回值

类型： uint32

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

返回代码/值 说明
S_OK
0 (0x0)
方法成功。
FVE_E_NOT_ALLOWED_IN_SAFE_MODE
2150694976 (0x80310040)
BitLocker 驱动器加密只能在安全模式下使用时用于恢复目的。
FVE_E_POLICY_PASSPHRASE_NOT_ALLOWED
2150695018 (0x8031006A)
组策略不允许创建通行短语。
FVE_E_FIPS_PREVENTS_PASSPHRASE
2150695020 (0x8031006C)
要求符合 FIPS 的组策略设置阻止生成或使用通行短语。
FVE_E_POLICY_INVALID_PASSPHRASE_LENGTH
2150695040 (0x80310080)
提供的通行短语不满足最小或最大长度要求。
FVE_E_POLICY_PASSPHRASE_TOO_SIMPLE
2150695041 (0x80310081)
通行短语不满足管理员在组策略中设置的复杂性要求。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
卷已被 BitLocker 驱动器加密锁定。 必须从控制面板解锁驱动器。
FVE_E_OVERLAPPED_UPDATE
2150694948 (0x80310024)
加密卷的控制块已由另一个线程更新。
FVE_E_KEY_PROTECTOR_NOT_SUPPORTED
2150695017 (0x80310069)
当前卷上的 BitLocker 驱动器加密版本不支持密钥保护程序。
FVE_E_OS_VOLUME_PASSPHRASE_NOT_ALLOWED
2150695021 (0x8031006D)
不能将通行短语添加到操作系统卷。
FVE_E_PROTECTOR_EXISTS
2150694960 (0x80310030)
此卷上已存在提供的密钥保护程序。

 

要求

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

请参阅

Win32_EncryptableVolume