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

IRP_MJ_DEVICE_CONTROL

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

Consulte también

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND