Bagikan melalui


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 ada.

Panjang buffer input

Tidak ada.

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 ini 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.

Keterangan

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS menghapus dan mengatur ulang kunci autentikasi secara kriptografis untuk setiap pita yang dikonfigurasi pada perangkat penyimpanan, satu band sekaligus. Jika semua band yang dikonfigurasi berhasil dihapus, IOCTL akan mengembalikan status sukses. Jika penghapusan gagal untuk satu atau beberapa band yang dikonfigurasi, IOCTL akan mengembalikan status kegagalan dari band 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 band yang dikonfigurasi. Dengan demikian, jika terjadi kegagalan sistem atau daya saat IOCTL ini sedang diproses, beberapa band yang dikonfigurasi mungkin telah berhasil dihapus sementara yang lain mungkin tidak.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 11, versi 22H2
Header ehstorbandmgmt.h

Lihat juga

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND