IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY IOCTL (ehstorbandmgmt.h)

Properti keamanan pita dalam perangkat penyimpanan yang dikelola pita dimodifikasi dengan permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY .

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Buffer di Irp-AssociatedIrp.SystemBuffer> harus berisi struktur SET_BAND_SECURITY_PARAMETERS diikuti oleh struktur AUTH_KEY dan BAND_SECURITY_INFO.

Jika anggota AuthKeyOffsetSET_BAND_SECURITY_PARAMETERS diatur ke EHSTOR_BANDMGR_NO_KEY, data input dalam buffer sistem tidak perlu menyertakan struktur AUTH_KEY . Selain itu, jika kunci autentikasi baru tidak diberikan, tidak ada struktur kunci yang diperbarui yang disertakan.

Panjang buffer input

Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang harus setidaknya ukuranof (SET_BAND_SECURITY_PARAMETERS) + 2 * sizeof(AUTH_KEY) + sizeof(BAND_SECURITY_INFO) ketika semua struktur input diperlukan.

Buffer output

Tidak ada.

Panjang buffer output

Tidak ada.

Blok status

Salah satu nilai berikut dapat dikembalikan di bidang Status .

Nilai Status	Deskripsi
STATUS_SUCCESS	Properti keamanan untuk pita diubah.
STATUS_INVALID_DEVICE_REQUEST	Perangkat penyimpanan tidak mendukung manajemen pita.
STATUS_INVALID_BUFFER_SIZE	Ukuran buffer input tidak valid.
STATUS_INVALID_PARAMETER	Informasi dalam buffer input tidak valid.
STATUS_NOT_FOUND	Pita tidak ditemukan untuk kriteria pilihan yang disediakan.
STATUS_ACCESS_DENIED	Kunci autentikasi yang disediakan tidak valid.
STATUS_IO_DEVICE_ERROR	Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan.

Keterangan

Penguncian baca dan tulis dan buka kunci untuk pita diatur dengan IOCTL ini dalam struktur BAND_SECURITY_INFO disertakan sebagai input dalam buffer sistem.

Perubahan kunci autentikasi tidak akan memengaruhi status kunci pita. Tidak perlu melepas volume untuk mengubah kunci autentikasi dengan permintaan ini.

Ketika band tidak terkunci, yang berarti anggota Readlock atau WriteLockdari BAND_SECURITY_INFO FALSE, driver silo akan menyimpan kunci autentikasi yang disediakan jika SETBANDSEC_AUTHKEY_CACHING_ENABLED diatur dalam anggota BenderaSET_BAND_SECURITY_PARAMETERS.

Sebagai kasus khusus, IOCTL ini dapat digunakan untuk memberi tahu driver silo bahwa band tidak terkunci tanpa menggunakan anggota penguncian di BAND_SECURITY_INFO. Untuk melakukan ini, anggota NewAuthKeyOffsetdari SET_BAND_SECURITY_PARAMETERS diatur ke CurrentAuthKeyOffset dengan BandSecurityInfoOffset diatur ke 0. Dalam hal ini, tidak ada perubahan keamanan yang terjadi, tetapi kunci yang disediakan di CurrentAuthKeyOffset di-cache dalam memori, asalkan SETBANDSEC_AUTHKEY_CACHING_ENABLED diatur dalam Bendera.

Perubahan yang dilakukan pada tabel pita oleh permintaan ini diterapkan pada perangkat secara atomik sebelum permintaan IOCTL selesai. Oleh karena itu, dijamin bahwa pita dimodifikasi dengan semua propertinya ditetapkan atau tidak ada properti yang ditetapkan sama sekali jika terjadi kegagalan sistem atau daya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia dimulai dengan Windows 8
Header	ehstorbandmgmt.h (termasuk EhStorBandMgmt.h)

Lihat juga

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

SET_BAND_SECURITY_PARAMETERS