IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
El IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS solicitud borra y restablece las claves de autenticación de todas las bandas configuradas de forma criptográfica.
Código principal
Búfer de entrada
Ninguno.
Longitud del búfer de entrada
Ninguno.
Búfer de salida
Ninguno.
Longitud del búfer de salida
Ninguno.
Búfer de entrada y salida
Ninguno.
Longitud del búfer de entrada y salida
Ninguno.
Bloque de estado
Se puede devolver uno de los siguientes valores en el campo estado de .
| Valor de estado | Descripción |
|---|---|
| STATUS_SUCCESS | Todas las bandas se borraron correctamente. |
| STATUS_INVALID_DEVICE_REQUEST | El dispositivo de almacenamiento no admite la administración de bandas. |
| STATUS_IO_DEVICE_ERROR | Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad. |
Observaciones
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS borra y restablece criptográficamente la clave de autenticación para cada banda configurada en el dispositivo de almacenamiento, una banda a la vez. Si se borran correctamente todas las bandas configuradas, el IOCTL devolverá un estado correcto. Si se produce un error de borrado para una o varias bandas configuradas, el IOCTL devolverá el estado de error de la primera banda configurada para la que se produjo un error. En este caso, un cliente debe volver a llamar a IOCTL_EHSTOR_BANDMGMT_ERASE_BAND para cada banda configurada.
No hay ninguna garantía de atomicidad proporcionada para la eliminación en varias bandas configuradas. Por lo tanto, si se produce un error de energía o sistema mientras se procesa este IOCTL, es posible que algunas bandas configuradas se hayan borrado correctamente, mientras que otras podrían no tener.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 11, versión 22H2 |
| encabezado de | ehstorbandmgmt.h |