IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND要求では、バンドの認証キーが暗号化によって消去され、リセットされます。 バンドの残りの構成は変更されません。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

Irp-AssociatedIrp.SystemBuffer の>入力バッファーには、ERASE_BAND_PARAMETERSと、場合によってはAUTH_KEY構造体が含まれている必要があります。

ERASE_BAND_PARAMETERSの NewAuthKeyOffset メンバーが EHSTOR_BANDMGR_NO_KEY に設定されている場合、システム バッファー内の入力データにAUTH_KEY構造体を含める必要はありません。

入力バッファーの長さ

Parameters.DeviceIoControl.InputBufferLength は、バッファーのサイズ (バイト単位) を示します。これは、少なくとも sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)である必要があります。

出力バッファー

[なし] :

出力バッファーの長さ

[なし] :

入力/出力バッファー

[なし] :

入力/出力バッファーの長さ

[なし] :

ステータス ブロック

[状態] フィールドには、次のいずれかの値を返すことができます。

状態の値	説明
STATUS_SUCCESS	バンドは正常に消去されました。
STATUS_INVALID_DEVICE_REQUEST	ストレージ デバイスは、バンド管理をサポートしていません。
STATUS_INVALID_BUFFER_SIZE	入力バッファーのサイズが正しくありません。
STATUS_INVALID_PARAMETER	入力バッファー内の情報が無効です。
STATUS_ACCESS_DENIED	消去認証キーは既定のキーではなく、バンドを消去できません。
STATUS_NOT_FOUND	指定された選択基準に対してバンドが見つかりませんでした。
STATUS_IO_DEVICE_ERROR	通信に失敗しました。 ストレージ デバイスがセキュリティ プロトコルと互換性がない可能性があります。

注釈

現在の消去認証キーは、 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 要求では提供されません。 ストレージ デバイスの消去認証キーは、以前に構成されています。

Windows では、ストレージ デバイスの消去認証キーを変更する方法は提供されていません。 正しいパラメーターがシステム バッファーの入力として指定されている場合、この要求は成功するはずです。 消去認証キーが Windows の外部 (オペレーティング システムが異なるデュアルブート環境など) で変更された場合、この要求は失敗する可能性があります。

IOCTL_EHSTOR_BANDMGMT_ERASE_BANDでバンドが消去された場合、残っている以前のプロパティはバンドの開始とバンド サイズのみです。 前のメディア暗号化キーが削除され、新しいキーが生成されます。 ロックは、読み取りと書き込みの両方で PERSISTANT_UNLOCK に設定されます。 以前に設定したセキュリティ メタデータは消去されます。 ERASE_BAND_PARAMETERSで指定された新しい認証キーは、既定のキーの使用が示されていない限り設定されます。

他のアプリケーションが既定のキーを使用してバンドを制御して消去しないようにするには、新しい認証キーを IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 要求に含める必要があります。

この要求によってバンド テーブルに加えられた変更は、IOCTL 要求が完了する前に、デバイスにアトミックにコミットされます。 したがって、システムまたは電源障害が発生した場合は、すべてのプロパティが設定されているか、プロパティがまったく設定されていない状態でバンドが変更されていることが保証されます。

要件

要件	値
サポートされている最小のクライアント	Windows 8
Header	ehstorbandmgmt.h (EhStorBandMgmt.h を含む)

こちらもご覧ください

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS