IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
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
Búfer de entrada
El búfer de entrada en Irp->AssociatedIrp.SystemBuffer debe contener una 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 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 tamaño de (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 de:
| 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ó 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
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 o en algún 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 | Valor |
|---|---|
| cliente mínimo admitido | Disponible en Windows 8 y versiones posteriores de Windows. |
| encabezado de | ehstorbandmgmt.h (include EhStorBandMgmt.h) |