IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
El IOCTL_EHSTOR_BANDMGMT_ERASE_BAND solicitud borra y restablece criptográficamente la clave de autenticación de una banda. La configuración restante de la banda se deja sin modificar.
Código principal
Búfer de entrada
El búfer de entrada en Irp->AssociatedIrp.SystemBuffer debe contener una ERASE_BAND_PARAMETERS y posiblemente una estructura AUTH_KEY.
Si el miembro NewAuthKeyOffset de ERASE_BAND_PARAMETERS está establecido en EHSTOR_BANDMGR_NO_KEY, los datos de entrada del búfer del sistema no necesitan incluir una estructura de AUTH_KEY.
Longitud del búfer de entrada
Parameters.DeviceIoControl.InputBufferLength indica el tamaño, en bytes, del búfer, que debe ser al menos sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY).
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 | La banda se ha borrado correctamente. |
| STATUS_INVALID_DEVICE_REQUEST | El dispositivo de almacenamiento no admite la administración de bandas. |
| STATUS_INVALID_BUFFER_SIZE | El tamaño del búfer de entrada es incorrecto. |
| STATUS_INVALID_PARAMETER | La información del búfer de entrada no es válida. |
| STATUS_ACCESS_DENIED | La clave de autenticación de borrado no es una clave predeterminada y no se puede borrar la banda. |
| STATUS_NOT_FOUND | No se encontró la banda para los criterios de selección proporcionados. |
| STATUS_IO_DEVICE_ERROR | Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad. |
Observaciones
No se proporciona una clave de autenticación de borrado actual en una solicitud de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND. La clave de autenticación de borrado del dispositivo de almacenamiento se ha configurado previamente.
No se proporciona ningún método en Windows para cambiar la clave de autenticación de borrado de un dispositivo de almacenamiento. Siempre que los parámetros correctos se proporcionen como entrada en el búfer del sistema, esta solicitud debe realizarse correctamente. Si se cambió la clave de autenticación de borrado fuera de Windows, como en un entorno de arranque dual con un sistema operativo diferente, esta solicitud puede producir un error.
Cuando se borra una banda con IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, las únicas propiedades anteriores que permanecen son el inicio de banda y el tamaño de banda. Se quita la clave de cifrado multimedia anterior y se genera una clave nueva. El bloqueo se establece en PERSISTANT_UNLOCK para la lectura y escritura. Los metadatos de seguridad establecidos anteriormente se borran. La nueva clave de autenticación especificada en ERASE_BAND_PARAMETERS se establece a menos que se indique el uso de la clave predeterminada.
Para evitar que otras aplicaciones tomen el control de una banda y borren mediante la clave predeterminada, se debe incluir una nueva clave de autenticación con la solicitud de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.
Los cambios realizados en la tabla de bandas por esta solicitud se confirman en el dispositivo de forma atómica antes de que se complete la solicitud IOCTL. Por lo tanto, se garantiza que la banda se modifica con todas sus propiedades establecidas o ninguna propiedad establecida en absoluto si se produce un error de alimentación o sistema.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8 |
| encabezado de | ehstorbandmgmt.h (include EhStorBandMgmt.h) |