IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
バンドに関連付けられているメタデータは、 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求で設定されます。 バンドのメタデータは、キー マネージャー アプリケーションのデータ領域として機能します。
メジャー コード
[入力バッファー]
Irp-AssociatedIrp.SystemBuffer> の入力バッファーには、バンドに設定する新しいメタデータと共に、SET_BAND_METADATA_PARAMETERSとAUTH_KEY構造が含まれている必要があります。
SET_BAND_METADATA_PARAMETERS の AuthKeyOffset メンバーがEHSTOR_BANDMGR_NO_KEYに設定されている場合、システム バッファー内の入力データにAUTH_KEY構造体を含める必要はありません。
入力バッファーの長さ
Parameters.DeviceIoControl.InputBufferLength は、バッファーのサイズ (バイト単位) を示します。バッファーのサイズは、少なくとも sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY) である必要があります。
出力バッファー
[なし] :
出力バッファーの長さ
[なし] :
ステータス ブロック
[状態] フィールドには、次のいずれかの値が返される場合があります。
| 状態の値 | 説明 |
|---|---|
| STATUS_SUCCESS | 選択したバンドにメタデータが設定されました。 |
| STATUS_INVALID_DEVICE_REQUEST | ストレージ デバイスでは、バンド管理はサポートされていません。 |
| STATUS_INVALID_BUFFER_SIZE | 入力バッファーのサイズが正しくありません。 |
| STATUS_INVALID_PARAMETER | 入力バッファー内の情報が無効です。 |
| STATUS_NOT_FOUND | 指定された選択基準に対してバンドが見つかりませんでした。 |
| STATUS_IO_DEVICE_ERROR | 通信に失敗しました。 ストレージ デバイスがセキュリティ プロトコルと互換性がない可能性があります。 |
注釈
メタデータは、この IOCTL を使用して消去することもできます。 バンドのメタデータを消去するには、入力バッファーのメタデータ部分をすべてのゼロまたは他の消去パターンに設定します。 メタデータ BLOB の機密情報を確実に削除するには、サイロ ドライバーのバンド テーブルからバンドを削除する前に、この消去操作を実行する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8以降のバージョンの Windows で使用できます。 |
| Header | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |