IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Метаданные, связанные с диапазоном, задаются с помощью запроса IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA . Метаданные для полосы служат областью данных для приложения диспетчера ключей.
Основной код
Входной буфер
Входной буфер в Irp-AssociatedIrp.SystemBuffer> должен содержать SET_BAND_METADATA_PARAMETERS и, возможно, структуру AUTH_KEY вместе с новыми метаданными, заданными для полосы.
Если для элемента AuthKeyOffsetSET_BAND_METADATA_PARAMETERS задано значение 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. Чтобы очистить метаданные для диапазона, задайте для части метаданных входного буфера все нули или другой шаблон стирания. Чтобы обеспечить удаление конфиденциальной информации в больших двоичных объектах метаданных, эту операцию стирания необходимо выполнить перед удалением полосы из таблицы контроллера драйвера хранилища.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows 8 и более поздних версиях Windows. |
| Верхняя часть | ehstorbandmgmt.h (включая EhStorBandMgmt.h) |