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

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

  • Статья

Параметры для создания полосы на запоминающее устройство для запроса 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
 Ключ проверки подлинности для этого диапазона кэшируется, что позволяет автоматизировать последующие операции. Ключ проверки подлинности кэшируется, когда этот флаг установлен, и полоса не блокируется для чтения и записи.

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

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

Ключ

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

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

Комментарии

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

Требования

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

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

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND