struktur CREATE_BAND_PARAMETERS (ehstorbandmgmt.h)

Artikel
08/07/2023

Parameter untuk membuat pita pada perangkat penyimpanan untuk permintaan IOCTL_EHSTOR_BANDMGMT_CREATE_BAND ditentukan dalam struktur CREATE_BAND_PARAMETERS .

Sintaks

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

Anggota

StructSize

Ukuran struktur ini dalam byte. Atur ke sizeof(CREATE_BAND_PARAMETERS).

Flags

Bendera pembuatan pita. Nilai ini adalah kombinasi bitwise OR dari berikut ini.

Nilai	Makna
CREATEBAND_AUTHKEY_CACHING_ENABLED	Kunci autentikasi untuk pita ini di-cache, yang memungkinkan otomatisasi operasi nanti. Kunci autentikasi di-cache ketika bendera ini diatur dan pita tidak dikunci untuk membaca dan menulis.

BandLocationInfoOffset

Offset, dalam byte, dari struktur BAND_LOCATION_INFO . Offset berasal dari awal CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Offset, dalam byte, dari struktur BAND_SECURITY_INFO . Offset berasal dari awal CREATE_BAND_PARAMETERS. Jika nilai ini adalah 0, artinya info keamanan pita tidak ada, metadata manajer kunci untuk band diatur ke semua nol. Selain itu, ketika anggota ini adalah 0, status kunci baca dan tulis default ke PERSISTANT_UNLOCK.

AuthKeyOffset

Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci otorisasi untuk band baru. Offset berasal dari awal CREATE_BAND_PARAMETERS. AUTH_KEY dinyatakan dalam ehstorbandmgmt.h sebagai berikut.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

Ukuran Kunci

Ukuran kunci, dalam byte, dari data kunci di Kunci. Jika KeySize diatur ke 0, kunci default akan digunakan.

Kunci

Array byte panjang variabel yang berisi data kunci.

Untuk menetapkan kunci otorisasi default ke band, atur AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

Keterangan

Anggota CryptoAlgoIdType dan CryptoAlgoOidString dari struktur BAND_SECURITY_INFO di BandSecurityInfoOffset tidak digunakan dalam permintaan pembuatan band 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_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

Share via