Win32_EncryptableVolume クラスの UnlockWithExternalKey メソッド
Win32_EncryptableVolume クラスの UnlockWithExternalKey メソッドは、指定された外部キーを使用してデータ ボリュームの内容にアクセスします。
このメソッドを使用してボリュームのロックを解除するには、 ProtectKeyWithExternalKey メソッドを使用して、ボリュームの暗号化キーを 1 つ以上のキー保護機能で保護する必要があります。
Note
ディスクがハードウェア暗号化をサポートしている場合、この関数はバンドの状態を "ロック解除" に設定します
構文
uint32 UnlockWithExternalKey(
[in] uint8 ExternalKey[]
);
パラメーター
-
ExternalKey [in]
-
型: uint8[]
ボリュームのロック解除に使用される 256 ビット外部キーを指定するバイト配列。 このキーは、 GetExternalKeyFromFile メソッドを呼び出すことによって取得できます。
戻り値
型: uint32
このメソッドは、次のいずれかのコードまたは失敗した場合は別のエラー コードを返します。
ボリュームが既にロック解除されている場合、このメソッドは 0 を返します。
| リターン コード/値 | 説明 |
|---|---|
|
メソッドは正常に実行されました。 |
|
ボリュームには、"外部キー" 型のキー保護機能がありません。 |
|
"外部キー" 型の 1 つ以上のキー保護機能が存在しますが、指定された ExternalKey パラメーターはボリュームのロックを解除できません。 |
|
ExternalKey パラメーターは、サイズ 4 の配列ではありません。 |
|
ボリュームで 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 |
|
関連項目