BAND_SECURITY_INFO struttura (ehstorbandmgmt.h)

  • Articolo

La struttura BAND_SECURITY_INFO specifica le informazioni di sicurezza per una query di voce della tabella band.

Sintassi

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;

Members

StructSize

Dimensioni della struttura in byte. Impostare su sizeof(BAND_SECURITY_INFO).

ReadLock

Se la banda è accessibile per la lettura e il modo in cui un blocco di lettura è interessato da una reimpostazione dell'alimentazione.

WriteLock

Se la banda è accessibile per la scrittura e il modo in cui un blocco di scrittura è interessato da una reimpostazione dell'alimentazione.

CryptoAlgoIdType

Tipo di identificatore dell'algoritmo di crittografia usato. Questa opzione deve essere impostata su AlgoIdTypeOidString.

CryptoAlgoOidString

Algoritmo di crittografia usato per proteggere i dati nella banda.

CryptoAlgoOidString.Offset

Offset dall'inizio di questa struttura in cui inizia la stringa OID dell'algoritmo di crittografia.

CryptoAlgoOidString.Length

Lunghezza della stringa OID che identifica l'algoritmo di crittografia. Si tratta di un valore di lunghezza byte, incluso un terminatore NULL per la stringa OID.

CryptoAlgoNumericId

Riservato.

Metadata[32]

Campo dei metadati disponibile per l'uso da parte di un gestore chiavi.

Commenti

Sia Readlock che Writelock sono valori LOCKSTATE e indicano lo stato di blocco e la persistenza del blocco. I valori sono uno dei seguenti.

Stato blocco Descrizione
INVALID_LOCK_STATE Lo stato di blocco non è valido.
PERSISTENT_UNLOCK Il dispositivo viene sbloccato e rimane sbloccato durante la reimpostazione dell'alimentazione.
NONPERSISTENT_UNLOCK Il dispositivo viene sbloccato ma viene bloccato durante la reimpostazione dell'alimentazione.
PERSISTENT_LOCK Il dispositivo è bloccato e rimane bloccato durante la reimpostazione dell'alimentazione.
 

CryptoAlgoOidString specifica l'algoritmo di crittografia dei dati solo se ENUMBANDS_REPORT_CRYPTO_ALGO è impostato nel membro Flag di ENUMERATE_BANDS_PARAMETERS in una richiesta di IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . In caso contrario, sia CryptoAlgoOidString.Offset che CryptoAlgoOidString.Length sono impostati su 0. Di seguito sono riportate le possibili stringhe OID dell'algoritmo di crittografia restituite per 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-INCORPORATE 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-INCORPORATE 2.16.840.1.101.3.4.1.44
AES256-XTS 1.3.111.2.1619.0.1.2
 

Quando BAND_SECURITY_INFO viene usato in un set di parametri di input, CryptoAlgoIdType eCryptoAlgoOidString non vengono usati e devono essere impostati su 0.

Requisiti

Requisito Valore
Client minimo supportato Disponibile a partire da Windows 8
Intestazione ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

BAND_TABLE_ENTRY

ENUMERATE_BANDS_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS