estructura BAND_SECURITY_INFO (ehstorbandmgmt.h)
La estructura BAND_SECURITY_INFO especifica la información de seguridad de una consulta de entrada de tabla de banda.
Sintaxis
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;
Miembros
StructSize
El tamaño de la estructura en bytes. Establézcalo en sizeof(BAND_SECURITY_INFO).
ReadLock
Si la banda es accesible para leer y cómo un bloqueo de lectura se ve afectado por un restablecimiento de energía.
WriteLock
Si la banda es accesible para escribir y cómo un bloqueo de escritura se ve afectado por un restablecimiento de energía.
CryptoAlgoIdType
Tipo de identificador de algoritmo de cifrado utilizado. Debe establecerse en AlgoIdTypeOidString.
CryptoAlgoOidString
Algoritmo de cifrado que se usa para proteger los datos de la banda.
CryptoAlgoOidString.Offset
Desplazamiento desde el principio de esta estructura donde comienza la cadena OID del algoritmo de cifrado.
CryptoAlgoOidString.Length
Longitud de la cadena de OID que identifica el algoritmo de cifrado. Se trata de un valor de longitud de bytes que incluye un terminador NULL para la cadena OID.
CryptoAlgoNumericId
Reservado.
Metadata[32]
Un campo de metadatos disponible para su uso por parte de un administrador de claves.
Comentarios
Readlock y Writelock son valores LOCKSTATE e indican el estado de bloqueo y la persistencia del bloqueo. Sus valores son uno de los siguientes.
| Estado de bloqueo | Descripción |
|---|---|
| INVALID_LOCK_STATE | El estado de bloqueo no es válido. |
| PERSISTENT_UNLOCK | El dispositivo está desbloqueado y permanece desbloqueado durante el restablecimiento de energía. |
| NONPERSISTENT_UNLOCK | El dispositivo está desbloqueado, pero se bloquea durante el restablecimiento de energía. |
| PERSISTENT_LOCK | El dispositivo está bloqueado y permanece bloqueado durante el restablecimiento de energía. |
CryptoAlgoOidString especifica el algoritmo de cifrado de datos solo si ENUMBANDS_REPORT_CRYPTO_ALGO está establecido en el miembro Flags de ENUMERATE_BANDS_PARAMETERS en una solicitud de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . De lo contrario, cryptoAlgoOidString.Offset y CryptoAlgoOidString.Length se establecen en 0. A continuación se muestran las cadenas OID del algoritmo de cifrado posibles devueltas para CryptoAlgoOidString.
| Algoritmo | OID |
|---|---|
| IAES128 BCE | 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 |
Cuando se usa BAND_SECURITY_INFO en un conjunto de parámetros de entrada, CryptoAlgoIdType y CryptoAlgoOidString no se usan y deben establecerse en 0.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible a partir de Windows 8 |
| Encabezado | ehstorbandmgmt.h (incluya EhStorBandMgmt.h) |