IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ é enviado pelo EHSTOR (Enhanced Storage Class Driver) para o driver de silo para iniciar a autenticação sob demanda ou a desautenticação.
Código principal
Buffer de entrada
O buffer de entrada em Irp-AssociatedIrp.SystemBuffer> deve conter uma estrutura AUTHZ_STATE que indique o tipo de operação de autenticação a ser executada. AUTHZ_STATE é declarado em ehstorioctl.h como o seguinte.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
O valor de AuthzState especifica a operação de autenticação. Este é um dos itens a seguir.
| Valor | Descrição |
|---|---|
| 0 | Execute a desautenticação sob demanda. |
| AUTHZSTATE_AUTHENTICATE | Executar a autenticação sob demanda. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Execute a desautenticação sob demanda e limpe as chaves de autenticação armazenadas em cache. |
Comprimento do buffer de entrada
O comprimento de uma estrutura AUTHZ_STATE .
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Bloco de status
STATUS_SUCCESS será retornado no campo Status pelo driver de silo se o estado de autenticação for alterado. Caso contrário, STATUS_UNSUCCESSFUL será retornado.
Comentários
Esse IOCTL é enviado pelo EHSTOR para um driver de silo que dá suporte à autenticação sob demanda. O driver de silo notifica o EHSTOR dessa funcionalidade em uma solicitação de IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES anterior com o sinalizador CAP_ON_DEMAND_AUTHENTICATION definido no membro Recursos do SILO_DRIVER_CAPABILITES.
Em resposta a esse IOCTL, o driver de silo executa autenticação ou desautenticação para o dispositivo. Para dispositivos em banda, o driver de silo, dependendo da operação especificada no buffer do sistema, desbloqueará ou bloqueará o máximo possível de bandas para leituras e gravações.
Se o driver de silo não executar a operação solicitada, ele não alterará o estado de autenticação de um dispositivo.
Se o membro AuthzState do AUTHZ_STATE estiver definido como AUTHZSTATE_CLEAR_AUTHKEY_CACHE, o driver de silo limpará seu cache de chave de autenticação, além de desautenticar. AUTHZSTATE_CLEAR_AUTHKEY_CACHE é definido quando o sistema está desligando ou hibernando. Isso impede a presença do cache de chaves no arquivo de hibernação.
Se um dispositivo der suporte a vários silos, a autenticação por cada silo será exclusiva. Uma operação de autenticação por um driver de silo não afeta o estado de autenticação definido por outro driver de silo.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 8 |
| Cabeçalho | ehstorioctl.h (inclua EhStorIoctl.h) |