IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Metadata yang terkait dengan pita diatur dengan permintaan IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA . Metadata untuk band berfungsi sebagai area data untuk aplikasi manajer kunci.
Kode utama
Buffer input
Buffer input di Irp-AssociatedIrp.SystemBuffer> harus berisi SET_BAND_METADATA_PARAMETERS dan mungkin struktur AUTH_KEY bersama dengan metadata baru yang akan diatur untuk band.
Jika anggota AuthKeyOffsetSET_BAND_METADATA_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 harus setidaknya sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY).
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 | Metadata diatur untuk pita yang dipilih. |
| 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_NOT_FOUND | Pita tidak ditemukan untuk kriteria pilihan yang disediakan. |
| STATUS_IO_DEVICE_ERROR | Komunikasi gagal. Perangkat penyimpanan mungkin tidak kompatibel dengan protokol keamanan. |
Keterangan
Metadata juga dapat dihapus dengan menggunakan IOCTL ini. Untuk menghapus metadata untuk pita, atur bagian metadata buffer input ke semua nol atau beberapa pola penghapusan lainnya. Untuk memastikan penghapusan informasi sensitif dalam blob metadata, operasi penghapusan ini harus dilakukan sebelum menghapus pita dari tabel band driver silo.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows versi Windows 8 dan yang lebih baru. |
| Header | ehstorbandmgmt.h (termasuk EhStorBandMgmt.h) |