Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Se elimina una banda configurada en un dispositivo de almacenamiento con la solicitud IOCTL_EHSTOR_BANDMGMT_DELETE_BAND. Una opción de borrado en los parámetros de entrada permite que la solicitud realice una borrado criptográfico de los datos de banda.
Código principal
Búfer de entrada
El búfer de entrada en Irp->AssociatedIrp.SystemBuffer debe contener una DELETE_BAND_PARAMETERS y posiblemente una estructura AUTH_KEY.
Si el miembro AuthKeyOffset de DELETE_BAND_PARAMETERS se establece en EHSTOR_BANDMGR_NO_KEY, los datos de entrada del búfer del sistema no necesitan incluir una estructura 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 tamaño de (DELETE_BAND_PARAMETERS) + tamaño de(AUTH_KEY).
Búfer de salida
Ninguno.
Longitud del búfer de 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 eliminó 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 no es válida o la banda está bloqueada para escribir. |
| 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
Se requiere una clave de autenticación para eliminar una banda sin realizar primero una borrado. Para solicitar un borrado de banda, la marca DELBAND_ERASE_BEFORE_DELETE se establece en el miembro Flags de de DELETE_BAND_PARAMETERS.
Después de eliminar una banda, todos los LBA contenidos en la banda eliminada se devuelven a la banda global. Las condiciones de bloqueo de la banda global ahora se aplican a los LBA devueltos a la banda global. Los LBA devueltos a la banda global ahora están asociados a la clave multimedia de la banda global y los datos cifrados de esas LBA no son irrecuperables.
La banda eliminada permanece en la tabla de bandas del controlador de silo, pero se vuelve sin configurar. La clave de autenticación se restablece al valor predeterminado, los metadatos de banda y clave contienen ceros y los estados de bloqueo vuelven a PERSISTENT_UNLOCK. La banda ya está disponible para la reconfiguración con una solicitud de IOCTL_EHSTOR_BANDMGMT_CREATE_BAND.
La eliminación de una banda sin borrado criptográfico no quitará la clave de cifrado de esa banda. Es posible crear posteriormente una banda con la misma configuración e identificador de banda que la banda eliminada. En este caso, los datos almacenados anteriormente en la banda y no sobrescritos, ya que la eliminación de la banda anterior estará disponible. Para evitar esta situación, elimine la banda con la marca DELBAND_ERASE_BEFORE_DELETE establecida en DELETE_BAND_PARAMETERS.
El IOCTL_EHSTOR_BANDMGMT_DELETE_BAND no eliminará la banda global. Una solicitud para hacerlo devolverá STATUS_INVALID_PARAMETER.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Disponible a partir de Windows 8. |
| encabezado de | ehstorbandmgmt.h (include EhStorBandMgmt.h) |