структура DELETE_BAND_PARAMETERS (ehstorbandmgmt.h)

Статья
02/26/2024

Настроенный диапазон удаляется в соответствии с параметрами в структуре DELETE_BAND_PARAMETERS . Эта структура является входной для запроса IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .

Синтаксис

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Члены

StructSize

Размер этой структуры в байтах. Задайте значение sizeof(DELETE_BAND_PARAMETERS).

Flags

Удалить флаги операций. Это значение является побитовой комбинацией ИЛИ следующего.

Значение	Значение
DELBAND_ERASE_BEFORE_DELETE	Выполните криптографическое удаление данных свойства band перед удалением.

Reserved

Зарезервировано.

BandId

Идентификатор одного диапазона для возврата сведений. BandSize должен иметь значение 0, если выбрана одна полоса с идентификатором BandId. Чтобы использовать BandStart и BandSize вместо BandId для выбора полосы, задайте bandId = (ULONG) –1.

BandStart

Начальное расположение байтов на запоминающее устройство для начала поиска по полосе. Предпринята попытка сопоставить группу в bandStart или после нее.

AuthKeyOffset

Смещение в байтах структуры AUTH_KEY , содержащей ключ авторизации для полосы. Смещение начинается с начала DELETE_BAND_PARAMETERS. AUTH_KEY объявляется в ehstorbandmgmt.h следующим образом.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Размер ключа в байтах данных ключа в разделе Ключ. Если параметр KeySize имеет значение 0, используется ключ по умолчанию.

Ключ

Массив байтов переменной длины, содержащий ключевые данные.

Чтобы указать ключ проверки подлинности по умолчанию для диапазона, задайте authKeyOffset = EHSTOR_BANDMGR_NO_KEY. Если параметр Flags содержит DELBAND_ERASE_BEFORE_DELETE, параметру AuthKeyOffset необходимо задать значение EHSTOR_BANDMGR_NO_KEY.

Приоритет присваивается BandID для выбора полосы. Если bandID больше 0, а BandID меньше, чем элемент MaxBandCountBAND_MANAGEMENT_CAPABILITIES, то BandID используется в качестве единственного критерия выбора для совпадения диапазона. Если BandID == –1, в качестве критерия соответствия для выбора полосы используется BandStart . Если ни один диапазон не соответствует ни один из критериев выбора, STATUS_INVALID_PARAMETER возвращается в блоке IoStatus для IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Если DELBAND_ERASE_BEFORE_DELETE задано в разделе Флаги, то для удаления полосы не требуется ключ проверки подлинности. Если этот флаг не задан, текущий ключ проверки подлинности должен быть включен в AuthKeyOffset.

Требования

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

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

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND

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