IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
IOCTL_EHSTOR_BANDMGMT_ERASE_BAND запрос криптографически удаляет и сбрасывает ключ проверки подлинности полосы. Оставшаяся конфигурация полосы остается не измененной.
Основной код
Входной буфер
Входной буфер в Irp->AssociatedIrp.SystemBuffer должен содержать ERASE_BAND_PARAMETERS и, возможно, структуру AUTH_KEY.
Если для элемента ERASE_BAND_PARAMETERS NewAuthKeyOffset задано значение EHSTOR_BANDMGR_NO_KEY, входные данные в буфере системы не должны содержать структуру AUTH_KEY.
Длина входного буфера
Parameters.DeviceIoControl.InputBufferLength указывает размер буфера в байтах, который должен быть по крайней мере sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).
Выходной буфер
Никакой.
Длина выходного буфера
Никакой.
Буфер входных и выходных данных
Никакой.
Длина буфера ввода и вывода
Никакой.
Блок состояния
Одно из следующих значений можно вернуть в поле Status.
| Значение состояния | Описание |
|---|---|
| STATUS_SUCCESS | Группа была успешно стерта. |
| STATUS_INVALID_DEVICE_REQUEST | Устройство хранения не поддерживает управление полосами. |
| STATUS_INVALID_BUFFER_SIZE | Неправильный размер входного буфера. |
| STATUS_INVALID_PARAMETER | Недопустимые сведения в входном буфере. |
| STATUS_ACCESS_DENIED | Ключ проверки подлинности удаления не является ключом по умолчанию, и не удается удалить полосу. |
| STATUS_NOT_FOUND | Группа не найдена для предоставленных условий выбора. |
| STATUS_IO_DEVICE_ERROR | Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности. |
Замечания
Текущий ключ проверки подлинности удаления не указан в запросе IOCTL_EHSTOR_BANDMGMT_ERASE_BAND. Ранее настроен ключ проверки подлинности удаления для устройства хранения.
Метод в Windows не предоставляется для изменения ключа проверки подлинности удаления для устройства хранения. При условии, что правильные параметры задаются в качестве входных данных в системном буфере, этот запрос должен завершиться успешно. Если ключ проверки подлинности удаления был изменен за пределами Windows, например в среде двойной загрузки с другой операционной системой, этот запрос может завершиться ошибкой.
При удалении полосы с IOCTL_EHSTOR_BANDMGMT_ERASE_BANDтолько предыдущие свойства, оставшиеся являются начальным и размером полосы. Предыдущий ключ шифрования мультимедиа удаляется и создается новый ключ. Блокировка имеет значение PERSISTANT_UNLOCK для чтения и записи. Ранее заданные метаданные безопасности удаляются. Новый ключ проверки подлинности, указанный в ERASE_BAND_PARAMETERS, устанавливается, если не указано использование ключа по умолчанию.
Чтобы предотвратить контроль над полосой и удалением других приложений с помощью ключа по умолчанию, новый ключ проверки подлинности должен быть включен в запрос IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.
Изменения, внесенные в таблицу групп, по этому запросу фиксируются на устройстве атомарно до завершения запроса IOCTL. Поэтому гарантируется, что полоса изменена со всеми его наборами свойств или никакие свойства вообще не должны возникать в системе или сбое питания.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 8 |
| заголовка | ehstorbandmgmt.h (include EhStorBandMgmt.h) |