次の方法で共有

Win32_EncryptableVolume クラスの ProtectKeyWithPassphrase メソッド

  • [アーティクル]

Win32_EncryptableVolume クラスの ProtectKeyWithPassphrase メソッドは、パスフレーズを使用して派生キーを取得します。 派生キーが計算されると、暗号化されたボリュームのマスター キーをセキュリティで保護するために派生キーが使用されます。

構文

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

パラメーター

FriendlyName [in, optional]

型: string

このキー保護機能のユーザー割り当て文字列識別子を指定する文字列。 このパラメーターを指定しない場合は、空白の値が使用されます。

パスフレーズ [入力]

型: string

パスフレーズを指定する文字列。

VolumeKeyProtectorID [out]

型: string

作成されたキー保護機能を一意に識別する文字列。

ドライブがハードウェア暗号化をサポートしていて、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 Enterprise、Windows 7 Ultimate [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 R2 [デスクトップ アプリのみ]
名前空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

関連項目

Win32_EncryptableVolume