struktur SET_BAND_SECURITY_PARAMETERS (ehstorbandmgmt.h)
Parameter untuk mengatur properti keamanan untuk pita pada perangkat penyimpanan untuk permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY ditentukan dalam struktur SET_BAND_SECURITY_PARAMETERS .
Sintaks
typedef struct _SET_BAND_SECURITY_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG CurrentAuthKeyOffset;
ULONG NewAuthKeyOffset;
ULONG BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;
Anggota
StructSize
Ukuran struktur ini dalam byte. Atur ke sizeof(SET_BAND_SECURITY_PARAMETERS).
Flags
Bendera parameter keamanan. Nilai ini adalah kombinasi bitwise OR dari yang berikut ini.
| Nilai | Makna |
|---|---|
|
Kunci autentikasi baru dapat di-cache untuk mengotomatiskan beberapa operasi pita. |
Reserved
BandId
Pengidentifikasi satu pita untuk mengembalikan informasi. BandSize harus 0 ketika satu pita dipilih dengan BandId. Untuk menggunakan BandStart dan BandSize alih-alih BandId untuk memilih pita, atur BandId = (ULONG) –1.
BandStart
Lokasi byte awal pada perangkat penyimpanan untuk memulai pencarian band. Upaya dilakukan untuk mencocokkan band pada atau setelah BandStart.
CurrentAuthKeyOffset
Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci autentikasi saat ini untuk pita. Kunci autentikasi ini diperlukan dan harus ada mengikuti struktur ini. Offset berasal dari awal SET_BAND_SECURITY_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 dengan panjang variabel yang berisi data kunci.
Untuk menentukan kunci autentikasi default ke band, atur AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
NewAuthKeyOffset
Offset, dalam byte, dari struktur AUTH_KEY yang berisi kunci autentikasi baru untuk pita. Offset berasal dari awal SET_BAND_SECURITY_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 dengan panjang variabel yang berisi data utama.
Untuk menetapkan kunci autentikasi default ke band, atur AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Jika NewAuthKeyOffset == CurrentAuthKeyOffset, kunci autentikasi untuk band dibiarkan tidak berubah.
BandSecurityInfoOffset
Offset, dalam byte, dari struktur BAND_SECURITY_INFO . Offset berasal dari awal SET_BAND_SECURITY_PARAMETERS.
Keterangan
Prioritas diberikan kepada BandID untuk pemilihan band. Jika BandID lebih besar dari 0 dan BandID kurang dari anggota MaxBandCountBAND_MANAGEMENT_CAPABILITIES, maka BandID digunakan sebagai satu-satunya kriteria pilihan untuk kecocokan band. Jika BandID == –1, maka BandStart digunakan sebagai kriteria pencocokan untuk memilih pita. Jika tidak ada band yang cocok dengan salah satu kriteria pilihan, STATUS_INVALID_PARAMETER dikembalikan di blok IoStatus untuk IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY.
Jika BandID dan BandStart keduanya diatur ke -1, permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY akan mengubah properti band global.
NewAuthKeyOffset dan BandSecurityInfoOffset bersifat opsional tergantung pada persyaratan operasi. Jika hanya kunci autentikasi yang diubah, maka NewAuthKeyOffset diatur ke lokasi struktur AUTH_KEY untuk kunci baru dan BandSecurityInfoOffset diatur ke nol. Demikian pula, jika hanya properti keamanan yang diubah, BandSecurityInfoOffset diatur ke lokasi BAND_SECURITY_INFO dan NewAuthKeyOffset diatur ke 0.
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) |