struktur BAND_SECURITY_INFO (ehstorbandmgmt.h)

  • Artikel

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)

Lihat juga

BAND_TABLE_ENTRY

ENUMERATE_BANDS_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ENUMERATE_BANDS