Win32_EncryptableVolume 類別的 ProtectKeyWithPassphrase 方法

  • 發行項

Win32_EncryptableVolume類別的ProtectKeyWithPassphrase方法會使用複雜密碼來取得衍生的金鑰。 計算衍生金鑰之後，會使用衍生金鑰來保護加密磁片區的主要金鑰。

語法

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

參數

FriendlyName [in， optional]

類型： 字串

字串，指定此金鑰保護裝置的使用者指派字串識別碼。 如果未指定此參數，則會使用空白值。

複雜密碼 [in]

類型： 字串

指定複雜密碼的字串。

VolumeKeyProtectorID [out]

類型： 字串

可唯一識別所建立金鑰保護裝置的字串。

如果磁片磁碟機支援硬體加密，且 BitLocker 尚未取得訊號範圍擁有權，識別碼字串會設定為 「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