IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL （ehstorbandmgmt.h）
與頻帶相關聯的元數據會以 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 要求來設定。 頻帶的元數據可作為金鑰管理員應用程式的數據區域。
主要程序代碼
輸入緩衝區
Irp->AssociatedIrp.SystemBuffer 的輸入緩衝區必須包含 SET_BAND_METADATA_PARAMETERS，而且可能包含 AUTH_KEY 結構，以及要為帶狀結構設定的新元數據。
如果 AuthKeyOffsetSET_BAND_METADATA_PARAMETERS 成員設定為 EHSTOR_BANDMGR_NO_KEY，則系統緩衝區中的輸入數據不需要包含 AUTH_KEY 結構。
輸入緩衝區長度
Parameters.DeviceIoControl.InputBufferLength 表示緩衝區的大小，其大小至少必須是 sizeof （SET_BAND_METADATA_PARAMETERS） + MetadataSize + sizeof（AUTH_KEY）。
輸出緩衝區
沒有。
輸出緩衝區長度
沒有。
狀態區塊
下列其中一個值可能會在 [狀態] 字段中傳回：
| 狀態值 | 描述 |
|---|---|
| STATUS_SUCCESS | 已為選取的頻帶設定元數據。 |
| STATUS_INVALID_DEVICE_REQUEST | 存儲設備不支援頻帶管理。 |
| STATUS_INVALID_BUFFER_SIZE | 輸入緩衝區大小不正確。 |
| STATUS_INVALID_PARAMETER | 輸入緩衝區中的資訊無效。 |
| STATUS_NOT_FOUND | 在提供的選取準則中找不到頻帶。 |
| STATUS_IO_DEVICE_ERROR | 通訊失敗。 存儲設備可能與安全性通訊協定不相容。 |
言論
您也可以使用此 IOCTL 清除元數據。 若要清除帶狀的元數據，請將輸入緩衝區的元數據部分設定為所有零或某些其他清除模式。 為了確保移除元數據 Blob 中的敏感性資訊，必須先執行此清除作業，再從尋址接收器驅動程式的頻帶數據表中刪除頻帶。
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | 適用於 Windows 8 和更新版本的 Windows。 |
| 標頭 | ehstorbandmgmt.h （include EhStorBandMgmt.h） |