Share via

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

  • Статья

Структура BAND_SECURITY_INFO указывает сведения о безопасности для запроса на ввод таблицы диапазона.

Синтаксис

typedef struct _BAND_SECURITY_INFO {
  ULONG      StructSize;
  LOCKSTATE  ReadLock;
  LOCKSTATE  WriteLock;
  ALGOIDTYPE CryptoAlgoIdType;
  union {
    struct {
      ULONG Offset;
      ULONG Length;
    } CryptoAlgoOidString;
    ULONG CryptoAlgoNumericId;
  };
  BYTE       Metadata[32];
} BAND_SECURITY_INFO, *PBAND_SECURITY_INFO;

Члены

StructSize

Размер структуры в байтах. Задайте для параметра sizeof(BAND_SECURITY_INFO).

ReadLock

Доступна ли полоса для чтения и как на блокировку чтения влияет сброс питания.

WriteLock

Доступна ли полоса для записи и как на блокировку записи влияет сброс питания.

CryptoAlgoIdType

Тип используемого идентификатора алгоритма шифрования. Для этого параметра должно быть задано значение AlgoIdTypeOidString.

CryptoAlgoOidString

Алгоритм шифрования, используемый для защиты данных в диапазоне.

CryptoAlgoOidString.Offset

Смещение от начала этой структуры, где начинается строка OID алгоритма шифрования.

CryptoAlgoOidString.Length

Длина строки OID, определяющей алгоритм шифрования. Это значение длины в байтах, включая признак конца NULL для строки OID.

CryptoAlgoNumericId

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

Metadata[32]

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

Комментарии

Readlock и Writelock являются значениями LOCKSTATE и указывают состояние блокировки и сохраняемость блокировки. Их значения являются одним из следующих.

Состояние блокировки Описание
INVALID_LOCK_STATE Недопустимое состояние блокировки.
PERSISTENT_UNLOCK Устройство разблокировано и остается разблокированным во время сброса питания.
NONPERSISTENT_UNLOCK Устройство разблокировано, но блокируется во время сброса питания.
PERSISTENT_LOCK Устройство заблокировано и остается заблокированным во время сброса питания.
 

CryptoAlgoOidString задает алгоритм шифрования данных, только если ENUMBANDS_REPORT_CRYPTO_ALGO задан в элементе FlagsENUMERATE_BANDS_PARAMETERS в запросе IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . В противном случае для cryptoAlgoOidString.Offset и CryptoAlgoOidString.Length задано значение 0. Ниже приведены возможные строки OID алгоритма шифрования, возвращаемые для CryptoAlgoOidString.

Алгоритм OID
IAES128-ЕЦБ 2.16.840.1.101.3.4.1.1
AES128-CBC 2.16.840.1.101.3.4.1.2.
AES128-OFB 2.16.840.1.101.3.4.1.3
AES128-CFB 2.16.840.1.101.3.4.1.4
AES128-XTS 1.3.111.2.1619.0.1.1
AES256-ECB 2.16.840.1.101.3.4.1.41
AES256-CBC 2.16.840.1.101.3.4.1.42
AES256-OFB 2.16.840.1.101.3.4.1.43
AES256-CFB 2.16.840.1.101.3.4.1.44
AES256-XTS 1.3.111.2.1619.0.1.2
 

Если BAND_SECURITY_INFO используется во входном наборе параметров, CryptoAlgoIdType и CryptoAlgoOidString не используются и должны иметь значение 0.

Требования

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

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

BAND_TABLE_ENTRY

ENUMERATE_BANDS_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS