IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
La 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 valores siguientes en el campo Estado .
| 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. |
Comentarios
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 todas las bandas configuradas se borran correctamente, 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 recurrir a la llamada a IOCTL_EHSTOR_BANDMGMT_ERASE_BAND para cada banda configurada.
No hay ninguna garantía de atomicidad proporcionada para el borrado en varias bandas configuradas. Por lo tanto, si se produce un error de alimentación o sistema mientras se está procesando este IOCTL, es posible que algunas bandas configuradas se hayan borrado correctamente, mientras que otras podrían no tener.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 22H2 |
| Encabezado | ehstorbandmgmt.h |