DELETE_BAND_PARAMETERS構造体 (ehstorbandmgmt.h)
構成されたバンドは、 DELETE_BAND_PARAMETERS 構造体のパラメーターに従って削除されます。 この構造体は、 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 要求の入力です。
構文
typedef struct _DELETE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;
メンバー
StructSize
この構造体のバイト単位のサイズ。 sizeof(DELETE_BAND_PARAMETERS) に設定します。
Flags
操作フラグを削除します。 この値は、次のビットごとの OR の組み合わせです。
| 値 | 意味 |
|---|---|
|
削除する前に、バンド プロパティ データの暗号化消去を実行します。 |
Reserved
予約済み。
BandId
情報を返す 1 つのバンドの識別子。 BandId で 1 つのバンドが選択されている場合、 BandSize は 0 である必要があります。 BandId の代わりに BandStart と BandSize を使用してバンドを選択するには、BandId = (ULONG) –1 を設定します。
BandStart
バンド検索を開始するストレージ デバイス上の開始バイト位置。 BandStart 以降でバンドとの一致が試行されます。
AuthKeyOffset
バンドの承認キーを含む AUTH_KEY 構造体のオフセット (バイト単位)。 オフセットは、 DELETE_BAND_PARAMETERSの先頭から取得されます。 AUTH_KEY は、 ehstorbandmgmt.h で次のように宣言されています。
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
Key のキー データのキーのサイズ (バイト単位)。 KeySize が 0 に設定されている場合は、既定のキーが使用されます。
キー
キー データを含む可変長バイト配列。
既定の認証キーをバンドに指定するには、 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEYを設定します。 Flags にDELBAND_ERASE_BEFORE_DELETEが含まれている場合は、AuthKeyOffset を EHSTOR_BANDMGR_NO_KEY に設定する必要があります。
注釈
バンド選択の優先順位は BandID に指定されます。 BandID が 0 より大きく、BandID が BAND_MANAGEMENT_CAPABILITIES の MaxBandCount メンバーより小さい場合、バンド一致の唯一の選択基準として BandID が使用されます。 BandID == –1 の場合、バンドを選択するための一致条件として BandStart が使用されます。 いずれかの選択基準に一致するバンドがない場合は、IOCTL_EHSTOR_BANDMGMT_DELETE_BANDの IoStatus ブロックに STATUS_INVALID_PARAMETERが返されます。
DELBAND_ERASE_BEFORE_DELETEが Flags で設定されている場合、バンドを削除するために認証キーは必要ありません。 このフラグが設定されていない場合、現在の認証キーは AuthKeyOffset に含まれている必要があります。
.
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 以降で使用可能 |
| Header | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |