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) + МетаданныеSize + sizeof(AUTH_KEY).
Выходной буфер
Никакой.
Длина выходного буфера
Никакой.
Блок состояния
Одно из следующих значений может быть возвращено в поле состояния:
| Значение состояния | Описание |
|---|---|
| STATUS_SUCCESS | Метаданные были заданы для выбранного диапазона. |
| STATUS_INVALID_DEVICE_REQUEST | Устройство хранения не поддерживает управление полосами. |
| STATUS_INVALID_BUFFER_SIZE | Неправильный размер входного буфера. |
| STATUS_INVALID_PARAMETER | Недопустимые сведения в входном буфере. |
| STATUS_NOT_FOUND | Группа не найдена для условий выбора. |
| STATUS_IO_DEVICE_ERROR | Сбой связи. Устройство хранения может быть несовместимо с протоколами безопасности. |
Замечания
Метаданные также можно удалить с помощью этого IOCTL. Чтобы удалить метаданные для полосы, задайте часть метаданных входного буфера на все нули или другой шаблон удаления. Чтобы обеспечить удаление конфиденциальной информации в больших двоичных объектах метаданных, перед удалением полосы драйвера silo необходимо выполнить эту операцию удаления.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows 8 и более поздних версиях Windows. |
| заголовка | ehstorbandmgmt.h (include EhStorBandMgmt.h) |