IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)

Permintaan IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS secara kriptografis menghapus dan mengatur ulang kunci autentikasi untuk semua pita yang dikonfigurasi.

Kode utama

IRP_MJ_DEVICE_CONTROL

Buffer input

Tidak.

Panjang buffer input

Tidak.

Buffer output

Tidak.

Panjang buffer output

Tidak.

Buffer Input/Output

Tidak.

Panjang buffer Input/Output

Tidak.

Blok status

Salah satu nilai berikut dapat dikembalikan di bidang Status.

Nilai Status	Deskripsi
STATUS_SUCCESS	Semua band berhasil dihapus.
STATUS_INVALID_DEVICE_REQUEST	Perangkat penyimpanan tidak mendukung manajemen pita.
STATUS_IO_DEVICE_ERROR	Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan.

Komentar

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS menghapus dan mengatur ulang kunci autentikasi secara kriptografis untuk setiap pita yang dikonfigurasi pada perangkat penyimpanan, satu pita sekaligus. Jika semua band yang dikonfigurasi berhasil dihapus, IOCTL akan mengembalikan status keberhasilan. Jika penghapusan gagal untuk satu atau beberapa pita yang dikonfigurasi, IOCTL akan mengembalikan status kegagalan dari pita pertama yang dikonfigurasi yang terjadi kesalahan. Dalam hal ini, klien harus kembali memanggil IOCTL_EHSTOR_BANDMGMT_ERASE_BAND untuk setiap band yang dikonfigurasi.

Tidak ada jaminan atomitas yang disediakan untuk penghapusan di beberapa pita yang dikonfigurasi. Dengan demikian, jika kegagalan sistem atau daya terjadi saat IOCTL ini sedang diproses, beberapa pita yang dikonfigurasi mungkin telah berhasil dihapus sementara yang lain mungkin tidak memilikinya.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows 11, versi 22H2
Header	ehstorbandmgmt.h

Lihat juga

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND