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

Статья
02/06/2025

Параметры для создания полосы на устройстве хранения для запроса IOCTL_EHSTOR_BANDMGMT_CREATE_BAND указываются в структуре CREATE_BAND_PARAMETERS.

Синтаксис

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

Члены

StructSize

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

Flags

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

Ценность	Значение
CREATEBAND_AUTHKEY_CACHING_ENABLED	Ключ проверки подлинности для этого диапазона кэшируется, что позволяет автоматизировать последующие операции. Ключ проверки подлинности кэшируется при установке этого флага, а полоса не заблокирована как для чтения, так и для записи.

Ценность

Значение

CREATEBAND_AUTHKEY_CACHING_ENABLED

Ключ проверки подлинности для этого диапазона кэшируется, что позволяет автоматизировать последующие операции. Ключ проверки подлинности кэшируется при установке этого флага, а полоса не заблокирована как для чтения, так и для записи.

BandLocationInfoOffset

Смещение в байтах структуры BAND_LOCATION_INFO. Смещение начинается с начала CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Смещение в байтах структуры BAND_SECURITY_INFO. Смещение начинается с начала CREATE_BAND_PARAMETERS. Если это значение равно 0, то есть сведения о безопасности группы отсутствуют, метаданные диспетчера ключей для полосы задаются на все нули. Кроме того, если этот элемент равен 0, состояния блокировки чтения и записи по умолчанию PERSISTANT_UNLOCK.

AuthKeyOffset

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

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

KeySize

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

Ключ

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

Чтобы назначить ключ авторизации по умолчанию группе, задайте AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Замечания

CryptoAlgoIdType и CryptoAlgoOidString члены структуры BAND_SECURITY_INFO в BandSecurityInfoOffset не используются в запросе на создание группы и должны иметь значение 0.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно начиная с Windows 8
заголовка	ehstorbandmgmt.h (include EhStorBandMgmt.h)

См. также

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

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