struttura BAND_SECURITY_INFO (ehstorbandmgmt.h)
La struttura BAND_SECURITY_INFO specifica le informazioni di sicurezza per una query di immissione di 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;
Membri
StructSize
Dimensione della struttura in byte. Impostare su sizeof(BAND_SECURITY_INFO).
ReadLock
Indica se la banda è accessibile per la lettura e il modo in cui un blocco di lettura è influenzato da una reimpostazione dell'alimentazione.
WriteLock
Indica se la banda è accessibile per la scrittura e il modo in cui un blocco di scrittura è influenzato da una reimpostazione dell'alimentazione.
CryptoAlgoIdType
Tipo di identificatore dell'algoritmo di crittografia utilizzato. Deve essere impostato 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 di byte che include un carattere di terminazione NULL per la stringa OID.
CryptoAlgoNumericId
Riservato.
Metadata[32]
Campo dei metadati disponibile per l'uso da parte di un gestore delle chiavi.
Osservazioni
Sia Readlock che writelock sono valori lockSTATE e indicano lo stato di blocco e la persistenza dei blocchi. I valori sono uno dei seguenti.
| Stato blocco | Descrizione |
|---|---|
| INVALID_LOCK_STATE | Lo stato del blocco non è valido. |
| PERSISTENT_UNLOCK | Il dispositivo viene sbloccato e rimane sbloccato durante il ripristino dell'alimentazione. |
| NONPERSISTENT_UNLOCK | Il dispositivo è sbloccato ma viene bloccato durante il ripristino dell'alimentazione. |
| PERSISTENT_LOCK | Il dispositivo è bloccato e rimane bloccato durante il ripristino 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-ECB | 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 |
Quando BAND_SECURITY_INFO viene usato in un set di parametri di input, CryptoAlgoIdType e CryptoAlgoOidString non vengono usati e devono essere impostati su 0.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8 |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |