この IOCTL_EHSTOR_BANDMGMT_REVERT 要求は、ストレージ デバイスのセキュリティ機能とバンド管理を非アクティブ化するために送信されます。 要求には、元に戻すオプションと認証キーが含まれます。
メジャー コード
入力バッファー
Irp->AssociatedIrp.SystemBuffer の入力バッファーには、 ACTIVATE_REVERT_PARAMETERS 構造体が含まれています。 ACTIVATE_REVERT_PARAMETERS は、次のように ehstorbandmgmt.h で宣言されています。
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
システム バッファー内の次の ACTIVATE_REVERT_PARAMETERS は、AUTH_KEY 構造体です。 これにより、認証キーのキー データ バイトが保持されます。 AUTH_KEY は、次のように ehstorbandmgmt.h で宣言されています。
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
入力バッファーの長さ
ACTIVATE_REVERT_PARAMETERS 構造体の長さ。
出力バッファー
何一つ。
出力バッファーの長さ
何一つ。
状態ブロック
Status フィールドには、次のいずれかの値が返されます。
| 状態の値 | 形容 |
|---|---|
| STATUS_SUCCESS | ストレージ デバイスのセキュリティ機能が非アクティブ化されました。 |
| STATUS_INVALID_DEVICE_REQUEST | ストレージ デバイスは、バンド管理をサポートしていません。 |
| STATUS_INVALID_BUFFER_SIZE | 入力バッファー サイズが無効です。 |
| STATUS_INVALID_PARAMETER | 入力バッファー内の情報が無効です。 |
| STATUS_ACCESS_DENIED | 認証キーが無効です。 非アクティブ化が拒否されました。 |
| STATUS_DEVICE_CONFIGURATION_ERROR | システムは、サポートされているモードでデバイスを構成できません。 |
| STATUS_IO_DEVICE_ERROR | 通信に失敗しました。 ストレージ デバイスがセキュリティ プロトコルと互換性がない可能性があります。 |
| STATUS_INVALID_DEVICE_STATE | ストレージ デバイスがアクティブ化されていません。 |
備考
IOCTL_EHSTOR_BANDMGMT_REVERT 要求から正常に戻ると、ストレージ デバイスは非アクティブなセキュリティ状態に戻り、IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES と IOCTL_EHSTOR_BANDMGMT_ACTIVATEを除くすべてのバンド管理 IOCTL が使用できなくなります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 以降で使用可能 |
| ヘッダー | ehstorbandmgmt.h (EhStorBandMgmt.h を含む) |