Win32_EncryptableVolume クラスの UnlockWithExternalKey メソッド

Win32_EncryptableVolume クラスの UnlockWithExternalKey メソッドは、指定された外部キーを使用してデータ ボリュームの内容にアクセスします。

このメソッドを使用してボリュームのロックを解除するには、 ProtectKeyWithExternalKey メソッドを使用して、ボリュームの暗号化キーを 1 つ以上のキー保護機能で保護する必要があります。

Note

ディスクがハードウェア暗号化をサポートしている場合、この関数はバンドの状態を "ロック解除" に設定します

 

構文

uint32 UnlockWithExternalKey(
  [in] uint8 ExternalKey[]
);

パラメーター

ExternalKey [in]

型: uint8[]

ボリュームのロック解除に使用される 256 ビット外部キーを指定するバイト配列。 このキーは、 GetExternalKeyFromFile メソッドを呼び出すことによって取得できます。

戻り値

型: uint32

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

ボリュームが既にロック解除されている場合、このメソッドは 0 を返します。

リターン コード/値	説明
S_OK 0 (0x0)	メソッドは正常に実行されました。
ERROR_NOT_FOUND 値が指定されていない (0x)	ボリュームには、"外部キー" 型のキー保護機能がありません。
ERROR_INVALID_PASSWORD 値が指定されていない (0x)	"外部キー" 型の 1 つ以上のキー保護機能が存在しますが、指定された ExternalKey パラメーターはボリュームのロックを解除できません。
E_INVALIDARG 2147942487 (0x80070057)	ExternalKey パラメーターは、サイズ 4 の配列ではありません。
FVE_E_NOT_ACTIVATED 2150694920 (0x80310008)	ボリュームで BitLocker が有効になっていません。 BitLocker を有効にするキー保護機能を追加します。

 

解説

マネージド オブジェクト形式 (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