Compartir a través de

IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

  • Artículo

Esta IOCTL_EHSTOR_BANDMGMT_REVERT solicitud se envía para desactivar las características de seguridad y la administración de bandas en un dispositivo de almacenamiento. La solicitud incluye opciones de reversión y la clave de autenticación.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de entrada de Irp-AssociatedIrp.SystemBuffer> contiene una estructura de ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS se declara en ehstorbandmgmt.h como se indica a continuación.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

El siguiente ACTIVATE_REVERT_PARAMETERS en el búfer del sistema es una estructura AUTH_KEY . Contiene los bytes de datos clave para la clave de autenticación. AUTH_KEY se declara en ehstorbandmgmt.h como se indica a continuación.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

Longitud del búfer de entrada

Longitud de una estructura de ACTIVATE_REVERT_PARAMETERS .

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Bloque de estado

Se puede devolver uno de los valores siguientes en el campo Estado .

Valor de estado Descripción
STATUS_SUCCESS Se desactivaron las características de seguridad en el dispositivo de almacenamiento.
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 no es válido.
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. Se deniega la desactivación.
STATUS_DEVICE_CONFIGURATION_ERROR El sistema no puede configurar el dispositivo en un modo compatible.
STATUS_IO_DEVICE_ERROR Error de comunicación. El dispositivo de almacenamiento podría ser incompatible con los protocolos de seguridad.
STATUS_INVALID_DEVICE_STATE El dispositivo de almacenamiento no está activado.

Comentarios

Si la devolución se realiza correctamente de una solicitud de IOCTL_EHSTOR_BANDMGMT_REVERT , el dispositivo de almacenamiento volverá a un estado de seguridad inactivo y a todas las ICTL de administración de bandas, excepto IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES y IOCTL_EHSTOR_BANDMGMT_ACTIVATE, dejará de estar disponible.

Requisitos

Requisito Value
Cliente mínimo compatible Disponible a partir de Windows 8
Encabezado ehstorbandmgmt.h (incluya EhStorBandMgmt.h)

Consulte también

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES