IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)

IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ envía el controlador de clase de almacenamiento mejorado (EHSTOR) al controlador de silo para iniciar la autenticación a petición o la desautenticación.

Código principal

IRP_MJ_DEVICE_CONTROL

Búfer de entrada

El búfer de entrada de Irp-AssociatedIrp.SystemBuffer> debe contener una estructura de AUTHZ_STATE que indica el tipo de operación de autenticación que se va a realizar. AUTHZ_STATE se declara en ehstorioctl.h como se indica a continuación.

typedef struct _AUTHZ_STATE
{
    ULONG AuthzState;
} AUTHZ_STATE;

El valor de AuthzState especifica la operación de autenticación. Esta es una de las siguientes.

Valor	Descripción
0	Realizar desautenticación a petición.
AUTHZSTATE_AUTHENTICATE	Realizar la autenticación a petición.
AUTHZSTATE_CLEAR_AUTHKEY_CACHE	Realizar desautenticación a petición y borrar claves de autenticación almacenadas en caché.

Longitud del búfer de entrada

Longitud de una estructura de AUTHZ_STATE .

Búfer de salida

Ninguno.

Longitud del búfer de salida

Ninguno.

Bloque de estado

STATUS_SUCCESS devuelve en el campo Estado el controlador de silo silo cambia el estado de autenticación. De lo contrario, se devuelve STATUS_UNSUCCESSFUL.

Comentarios

EHSTOR envía este IOCTL a un controlador de silo que admite la autenticación a petición. El controlador de silo notifica a EHSTOR esta funcionalidad en una solicitud de IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES anterior con la marca CAP_ON_DEMAND_AUTHENTICATION establecida en el miembro Capabilities de SILO_DRIVER_CAPABILITES.

En respuesta a este IOCTL, el controlador de silo realiza la autenticación o desautenticación del dispositivo. En el caso de los dispositivos en banda, el controlador de silo dependerá de la operación especificada en el búfer del sistema, desbloquee o bloquee tantas bandas como sea posible para lecturas y escrituras.

Si el controlador de silo no puede realizar la operación solicitada, no cambiará el estado de autenticación de un dispositivo.

Si el miembro AuthzState de AUTHZ_STATE se establece en AUTHZSTATE_CLEAR_AUTHKEY_CACHE, el controlador de silo borra su caché de claves de autenticación además de la autenticación. AUTHZSTATE_CLEAR_AUTHKEY_CACHE se establece cuando el sistema se apaga o hiberna. Esto evita la presencia de la caché de claves en el archivo de hibernación.

Si un dispositivo admite varios silos, la autenticación de cada silo es exclusiva. Una operación de autenticación por un controlador de silo no afecta al estado de autenticación establecido por otro controlador de silo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Disponible a partir de Windows 8
Encabezado	ehstorioctl.h (include EhStorIoctl.h)

Consulte también

IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES

SILO_DRIVER_CAPABILITES