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 フィールドには、次のいずれかの値が返される場合があります。
| 状態の値 | 形容 |
|---|---|
| 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 で使用できます。 |
| ヘッダー | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |