Compartir a través de

IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

  • Artículo

Los metadatos asociados a una banda se establecen con una solicitud de IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA . Los metadatos de una banda sirven como área de datos para una aplicación de administrador de claves.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de entrada en Irp-AssociatedIrp.SystemBuffer> debe contener un SET_BAND_METADATA_PARAMETERS y posiblemente una estructura de AUTH_KEY junto con los nuevos metadatos que se van a establecer para la banda.

Si el miembro AuthKeyOffset de SET_BAND_METADATA_PARAMETERS se establece 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 (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(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 :

Valor de estado Descripción
STATUS_SUCCESS Los metadatos se establecieron para la banda seleccionada.
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_NOT_FOUND No se encontró 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.

Comentarios

Los metadatos también se pueden borrar mediante este IOCTL. Para borrar los metadatos de una banda, establezca la parte de metadatos del búfer de entrada en todos los ceros u otro patrón de borrado. Para garantizar la eliminación de información confidencial en blobs de metadatos, esta operación de borrado debe realizarse antes de eliminar una banda de la tabla de bandas del controlador de silo.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible en Windows 8 y versiones posteriores de Windows.
Encabezado ehstorbandmgmt.h (include EhStorBandMgmt.h)

Consulte también

SET_BAND_METADATA_PARAMETERS