estructura BAND_SECURITY_INFO (ehstorbandmgmt.h)

Artículo
08/07/2023

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.