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 вместе с новыми метаданными, заданными для полосы.

Если для элемента 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)

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

SET_BAND_METADATA_PARAMETERS