IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
Permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND menghapus dan mengatur ulang kunci autentikasi band secara kriptografis. Konfigurasi band yang tersisa dibiarkan tidak dimodifikasi.
Kode utama
Buffer input
Buffer input di Irp-AssociatedIrp.SystemBuffer> harus berisi ERASE_BAND_PARAMETERS dan mungkin struktur AUTH_KEY.
Jika anggota NewAuthKeyOffsetERASE_BAND_PARAMETERS diatur ke EHSTOR_BANDMGR_NO_KEY, data input dalam buffer sistem tidak perlu menyertakan struktur AUTH_KEY .
Panjang buffer input
Parameters.DeviceIoControl.InputBufferLength menunjukkan ukuran, dalam byte, dari buffer, yang setidaknya harus sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)
.
Buffer output
Tidak ada.
Panjang buffer output
Tidak ada.
Buffer Input/Output
Tidak ada.
Panjang buffer Input/Output
Tidak ada.
Blok status
Salah satu nilai berikut dapat dikembalikan di bidang Status .
Nilai Status | Deskripsi |
---|---|
STATUS_SUCCESS | Band ini berhasil dihapus. |
STATUS_INVALID_DEVICE_REQUEST | Perangkat penyimpanan tidak mendukung manajemen pita. |
STATUS_INVALID_BUFFER_SIZE | Ukuran buffer input salah. |
STATUS_INVALID_PARAMETER | Informasi dalam buffer input tidak valid. |
STATUS_ACCESS_DENIED | Kunci autentikasi penghapusan bukan kunci default dan pita tidak dapat dihapus. |
STATUS_NOT_FOUND | Pita tidak ditemukan untuk kriteria pemilihan yang disediakan. |
STATUS_IO_DEVICE_ERROR | Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan. |
Keterangan
Kunci autentikasi penghapusan saat ini tidak disediakan dalam permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . Kunci autentikasi penghapusan untuk perangkat penyimpanan sebelumnya dikonfigurasi.
Tidak ada metode yang disediakan di Windows untuk mengubah kunci autentikasi penghapusan untuk perangkat penyimpanan. Asalkan parameter yang benar diberikan sebagai input dalam buffer sistem, permintaan ini harus berhasil. Jika kunci autentikasi penghapusan diubah di luar Windows, seperti di lingkungan boot ganda dengan sistem operasi yang berbeda, permintaan ini mungkin gagal.
Ketika pita dihapus dengan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, satu-satunya properti sebelumnya yang tersisa adalah mulai pita dan ukuran pita. Kunci enkripsi media sebelumnya dihapus dan kunci baru dibuat. Penguncian diatur ke PERSISTANT_UNLOCK untuk membaca dan menulis. Metadata keamanan yang sebelumnya diatur dihapus. Kunci autentikasi baru yang ditentukan dalam ERASE_BAND_PARAMETERS diatur kecuali penggunaan kunci default ditunjukkan.
Untuk mencegah aplikasi lain mengontrol pita dan menghapus dengan menggunakan kunci default, kunci autentikasi baru harus disertakan dengan permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .
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 | Windows 8 |
Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |