IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

Статья
02/29/2024

Этот IOCTL_EHSTOR_BANDMGMT_REVERT запрос отправляется для отключения функций безопасности и управления диапазоном на запоминающее устройство. Запрос включает отменить изменения параметры и ключ проверки подлинности.

Основной код

IRP_MJ_DEVICE_CONTROL

Входной буфер

Входной буфер в 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_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 управления диапазоном, за исключением IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES и IOCTL_EHSTOR_BANDMGMT_ACTIVATE, станут недоступными.

Требования

Требование	Значение
Минимальная версия клиента	Доступно, начиная с Windows 8
Верхняя часть	ehstorbandmgmt.h (включая EhStorBandMgmt.h)

См. также раздел

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Поделиться через