IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

バンドに関連付けられているメタデータは、 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求で設定されます。 バンドのメタデータは、キー マネージャー アプリケーションのデータ領域として機能します。

メジャー コード

IRP_MJ_DEVICE_CONTROL

[入力バッファー]

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 を含む)

こちらもご覧ください

SET_BAND_METADATA_PARAMETERS