BAND_SECURITY_INFO structure (ehstorbandmgmt.h)

Article
08/07/2023

La structure BAND_SECURITY_INFO spécifie les informations de sécurité d’une requête d’entrée de table de bande.

Syntaxe

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;

Membres

StructSize

Taille de la structure en octets. Défini sur sizeof(BAND_SECURITY_INFO).

ReadLock

Indique si la bande est accessible pour la lecture et comment un verrou de lecture est affecté par une réinitialisation de l’alimentation.

WriteLock

Indique si la bande est accessible pour l’écriture et comment un verrou d’écriture est affecté par une réinitialisation de l’alimentation.

CryptoAlgoIdType

Type d’identificateur d’algorithme de chiffrement utilisé. Cette valeur doit être définie sur AlgoIdTypeOidString.

CryptoAlgoOidString

Algorithme de chiffrement utilisé pour protéger les données dans la bande.

CryptoAlgoOidString.Offset

Décalage par rapport au début de cette structure où commence la chaîne OID de l’algorithme de chiffrement.

CryptoAlgoOidString.Length

Longueur de la chaîne OID identifiant l’algorithme de chiffrement. Il s’agit d’une valeur de longueur d’octets incluant un terminateur NULL pour la chaîne OID.

CryptoAlgoNumericId

Réservé.

Metadata[32]

Champ de métadonnées disponible pour une utilisation par un gestionnaire de clés.

Remarques

Readlock et Writelock sont des valeurs LOCKSTATE et indiquent l’état de verrouillage et la persistance des verrous. Leurs valeurs sont l’une des suivantes.

État de verrouillage	Description
INVALID_LOCK_STATE	L’état de verrou n’est pas valide.
PERSISTENT_UNLOCK	L’appareil est déverrouillé et reste déverrouillé lors de la réinitialisation de l’alimentation.
NONPERSISTENT_UNLOCK	L’appareil est déverrouillé, mais il est verrouillé lors de la réinitialisation de l’alimentation.
PERSISTENT_LOCK	L’appareil est verrouillé et reste verrouillé lors de la réinitialisation de l’alimentation.

CryptoAlgoOidString spécifie l’algorithme de chiffrement des données uniquement si ENUMBANDS_REPORT_CRYPTO_ALGO est défini dans le membre Indicateurs de ENUMERATE_BANDS_PARAMETERS dans une demande de IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . Sinon, CryptoAlgoOidString.Offset et CryptoAlgoOidString.Length ont la valeur 0. Voici les chaînes OID d’algorithme de chiffrement possibles retournées pour CryptoAlgoOidString.

Algorithm	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-BFC	2.16.840.1.101.3.4.1.4
AES128-XTS	1.3.111.2.1619.0.1.1
AES256-BCE	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-BFC	2.16.840.1.101.3.4.1.44
AES256-XTS	1.3.111.2.1619.0.1.2

Lorsque BAND_SECURITY_INFO est utilisé dans un jeu de paramètres d’entrée, CryptoAlgoIdType et CryptoAlgoOidString ne sont pas utilisés et doivent être définis sur 0.