Win32_EncryptableVolume クラスの GetKeyPackage メソッド

  • [アーティクル]

Win32_EncryptableVolume クラスの GetKeyPackage メソッドは、ドライブが深刻な損傷を受け、データ バックアップ ファイルが存在しない場合に、暗号化されたデータをサルベージするのに役立つ情報をエクスポートします。

エクスポートされた情報は、"数値パスワード" または "外部キー" の種類のキー保護機能によって保護されたボリュームの暗号化キーで構成されます。 このパッケージを使用するには、対応する数値パスワードまたは外部キーも保存する必要があります。

重要

キー パッケージをエクスポートする場合は、この情報を適切に保護された場所に保持することを確認してください。 この情報は、お使いのコンピューターに持ち込んではいないでください。 このキー パッケージが紛失または盗難にあった場合は、ボリュームの暗号化を解除し、新しいキーを使用して再暗号化する必要があります。

 

ドライブ障害が発生した場合は、BitLocker 修復ツールが存在し、使用可能なデータの復旧に役立ちます。 このツールでキー パッケージを使用する方法の詳細については、「 BitLocker 修復ツールを使用して、Windows Vista で暗号化されたボリュームからデータを回復する方法」を参照してください。

構文

uint32 GetKeyPackage(
  [in]  string VolumeKeyProtectorID,
  [out] uint8  KeyPackage[]
);

パラメーター

VolumeKeyProtectorID [in]

型: string

暗号化されたボリューム キー保護機能を管理するために使用される一意の文字列識別子。 キー パッケージをエクスポートするには、"数値パスワード" または "外部キー" 型のキー保護機能を使用する必要があります。

KeyPackage[] [out]

型: uint8

指定したキー保護機能によって保護された、ボリュームの暗号化キーを含むバイト ストリーム。

戻り値

型: uint32

このメソッドは、次のいずれかのコードまたは失敗した場合は別のエラー コードを返します。

リターン コード/値 説明
S_OK
0 (0x0)
 メソッドは正常に実行されました。
FVE_E_LOCKED_VOLUME
2150694912 (0x80310000)
 ボリュームがロックされています。
FVE_E_NOT_ACTIVATED
2150694920 (0x80310008)
 ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。
FVE_E_PROTECTOR_NOT_FOUND
2150694963 (0x80310033)
 指定されたキー保護機能がボリュームに存在しません。
FVE_E_INVALID_PROTECTOR_TYPE
2150694970 (0x8031003A)
 VolumeKeyProtectorID パラメーターは、型 "数値パスワード" または "外部キー" のキー保護機能を参照しません。 ProtectKeyWithNumericalPassword メソッドまたは ProtectKeyWithExternalKey メソッドを使用して、適切な型のキー保護機能を作成します。

 

解説

マネージド オブジェクト形式 (MOF) ファイルには、Windows Management Instrumentation (WMI) クラスの定義が含まれています。 MOF ファイルは、Windows SDK の一部としてインストールされません。 サーバー マネージャーを使用して関連付けられているロールを追加すると、サーバーにインストールされます。 MOF ファイルの詳細については、「 マネージド オブジェクト形式 (MOF)」を参照してください。

必要条件

要件 値
サポートされている最小のクライアント
 Windows Vista Enterprise、Windows Vista Ultimate [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2008 [デスクトップ アプリのみ]
名前空間
 Root\CIMV2\Security\MicrosoftVolumeEncryption
MOF
Win32_encryptablevolume.mof

関連項目

Win32_EncryptableVolume