структура 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) |