struktur BAND_SECURITY_INFO (ehstorbandmgmt.h)
Struktur BAND_SECURITY_INFO menentukan informasi keamanan untuk kueri entri tabel pita.
Sintaks
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;
Anggota
StructSize
Ukuran struktur dalam byte. Atur ke sizeof(BAND_SECURITY_INFO).
ReadLock
Apakah pita dapat diakses untuk membaca dan bagaimana kunci baca dipengaruhi oleh reset daya.
WriteLock
Apakah pita dapat diakses untuk menulis dan bagaimana kunci tulis dipengaruhi oleh reset daya.
CryptoAlgoIdType
Jenis pengidentifikasi algoritma enkripsi yang digunakan. Ini harus diatur ke AlgoIdTypeOidString.
CryptoAlgoOidString
Algoritma enkripsi yang digunakan untuk melindungi data dalam pita.
CryptoAlgoOidString.Offset
Offset dari awal struktur ini di mana string OID algoritma enkripsi dimulai.
CryptoAlgoOidString.Length
Panjang string OID yang mengidentifikasi algoritma enkripsi. Ini adalah nilai panjang byte termasuk terminator NULL untuk string OID.
CryptoAlgoNumericId
Dicadangkan.
Metadata[32]
Bidang metadata tersedia untuk digunakan oleh manajer kunci.
Keterangan
Readlock dan Writelock adalah nilai LOCKSTATE dan menunjukkan status penguncian dan kunci persistensi. Nilai-nilainya adalah salah satu dari berikut ini.
| Status Kunci | Deskripsi |
|---|---|
| INVALID_LOCK_STATE | Status kunci tidak valid. |
| PERSISTENT_UNLOCK | Perangkat tidak terkunci dan tetap tidak terkunci selama reset daya. |
| NONPERSISTENT_UNLOCK | Perangkat tidak terkunci tetapi menjadi terkunci selama reset daya. |
| PERSISTENT_LOCK | Perangkat terkunci dan tetap terkunci selama reset daya. |
CryptoAlgoOidString menentukan algoritma enkripsi data hanya jika ENUMBANDS_REPORT_CRYPTO_ALGO diatur dalam anggota BenderaENUMERATE_BANDS_PARAMETERS dalam permintaan IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS . Jika tidak, CryptoAlgoOidString.Offset dan CryptoAlgoOidString.Length diatur ke 0. Berikut ini adalah kemungkinan string OID algoritma enkripsi yang dikembalikan untuk CryptoAlgoOidString.
| Algoritma | 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 |
Ketika BAND_SECURITY_INFO digunakan dalam set parameter input, CryptoAlgoIdType dan CryptoAlgoOidString tidak digunakan dan harus diatur ke 0.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8 |
| Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |