IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS请求以加密方式擦除并重置所有已配置波段的身份验证密钥。
主要代码
输入缓冲区
无。
输入缓冲区长度
无。
输出缓冲区
无。
输出缓冲区长度
无。
输入/输出缓冲区
无。
输入/输出缓冲区长度
无。
状态块
可以在“ 状态” 字段中返回以下值之一。
| 状态值 | 说明 |
|---|---|
| STATUS_SUCCESS | 所有带都已成功擦除。 |
| STATUS_INVALID_DEVICE_REQUEST | 存储设备不支持带管理。 |
| STATUS_IO_DEVICE_ERROR | 通信失败。 存储设备可能与安全协议不兼容。 |
注解
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS 以加密方式擦除和重置存储设备上配置的每个带的身份验证密钥，一次一个波段。 如果成功擦除所有配置的带区，IOCTL 将返回成功状态。 如果一个或多个已配置的带区擦除失败，IOCTL 将从发生错误的第一个已配置波段返回失败状态。 在这种情况下，客户端应回退到为每个配置的带区调用 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 。
对于跨多个配置的带段的擦除，不提供原子性保证。 因此，如果在处理此 IOCTL 时发生系统或电源故障，则某些配置的带可能已成功擦除，而其他已配置的带区可能尚未清除。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 11 版本 22H2 |
| 标头 | ehstorbandmgmt.h |