IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ viene inviato dal driver EHSTOR (Enhanced Storage Class Driver) al driver silo per avviare l'autenticazione o la deautenticazione su richiesta.
Codice principale
Buffer di input
Il buffer di input in corrispondenza Irp->AssociatedIrp.SystemBuffer deve contenere una struttura AUTHZ_STATE che indica il tipo di operazione di autenticazione da eseguire. AUTHZ_STATE viene dichiarato in ehstorioctl.h come indicato di seguito.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
Il valore di AuthzState specifica l'operazione di autenticazione. Questo è uno dei seguenti.
| Valore | Descrizione |
|---|---|
| 0 | Eseguire la deautenticazione su richiesta. |
| AUTHZSTATE_AUTHENTICATE | Eseguire l'autenticazione su richiesta. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Eseguire la deautenticazione su richiesta e cancellare le chiavi di autenticazione memorizzate nella cache. |
Lunghezza del buffer di input
Lunghezza di una struttura AUTHZ_STATE.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco di stato
STATUS_SUCCESS viene restituito nel campo stato dal driver silo se lo stato di autenticazione viene modificato. In caso contrario, viene restituito STATUS_UNSUCCESSFUL.
Osservazioni
Questo IOCTL viene inviato da EHSTOR a un driver silo che supporta l'autenticazione su richiesta. Il driver silo notifica a EHSTOR di questa funzionalità in una richiesta di IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES precedente con il flag CAP_ON_DEMAND_AUTHENTICATION impostato nel Capabilities membro di SILO_DRIVER_CAPABILITES.
In risposta a questo IOCTL, il driver silo esegue l'autenticazione o la deautenticazione per il dispositivo. Per i dispositivi con banda, il driver silo, a seconda dell'operazione specificata nel buffer di sistema, sbloccare o bloccare il maggior numero possibile di bande per letture e scritture.
Se il driver silo non riesce a eseguire l'operazione richiesta, non cambierà lo stato di autenticazione di un dispositivo.
Se il membro AuthzState di AUTHZ_STATE è impostato su AUTHZSTATE_CLEAR_AUTHKEY_CACHE, il driver silo cancella la cache delle chiavi di autenticazione oltre alla deautenticazione. AUTHZSTATE_CLEAR_AUTHKEY_CACHE viene impostato quando il sistema sta arrestando o ibernando. In questo modo si impedisce la presenza della cache delle chiavi nel file di ibernazione.
Se un dispositivo supporta più silo, l'autenticazione per ogni silo è esclusiva. Un'operazione di autenticazione di un driver silo non influisce sullo stato di autenticazione impostato da un altro driver silo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8 |
| intestazione | ehstorioctl.h (include EhStorIoctl.h) |