IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ wird vom Enhanced Storage Class Driver (EHSTOR) an den Silotreiber gesendet, um die bedarfsgesteuerte Authentifizierung oder Deauthentifizierung zu initiieren.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp-AssociatedIrp.SystemBuffer> muss eine AUTHZ_STATE-Struktur enthalten, die den Typ des auszuführenden Authentifizierungsvorgangs angibt. AUTHZ_STATE wird in ehstorioctl.h wie folgt deklariert.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
Der Wert von AuthzState gibt den Authentifizierungsvorgang an. Dies ist einer der folgenden.
| Wert | BESCHREIBUNG |
|---|---|
| 0 | Führen Sie die bedarfsgesteuerte Authentifizierung aus. |
| AUTHZSTATE_AUTHENTICATE | Führen Sie die bedarfsgesteuerte Authentifizierung aus. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Führen Sie die bedarfsgesteuerte Authentifizierung aus, und löschen Sie zwischengespeicherte Authentifizierungsschlüssel. |
Länge des Eingabepuffers
Die Länge einer AUTHZ_STATE-Struktur .
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
STATUS_SUCCESS wird im Feld Status vom Silotreiber zurückgegeben, wenn der Authentifizierungsstatus geändert wird. Andernfalls wird STATUS_UNSUCCESSFUL zurückgegeben.
Hinweise
Diese IOCTL wird von EHSTOR an einen Silotreiber gesendet, der die bedarfsgesteuerte Authentifizierung unterstützt. Der Silotreiber benachrichtigt EHSTOR über diese Funktion in einer vorherigen IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES-Anforderung , wobei das flag CAP_ON_DEMAND_AUTHENTICATION im Capabilities-Member von SILO_DRIVER_CAPABILITES festgelegt ist.
Als Reaktion auf diese IOCTL führt der Silotreiber die Authentifizierung oder Deauthentifizierung für das Gerät durch. Bei gebänderten Geräten entsperrt oder sperrt der Silotreiber je nach dem angegebenen Vorgang im Systempuffer so viele Bänder wie möglich für Lese- und Schreibvorgänge.
Wenn der Silotreiber den angeforderten Vorgang nicht ausführt, ändert er den Authentifizierungsstatus eines Geräts nicht.
Wenn das AuthzState-Element von AUTHZ_STATE auf AUTHZSTATE_CLEAR_AUTHKEY_CACHE festgelegt ist, löscht der Silotreiber seinen Authentifizierungsschlüsselcache zusätzlich zur Deauthentisierung. AUTHZSTATE_CLEAR_AUTHKEY_CACHE wird festgelegt, wenn das System heruntergefahren oder in den Ruhezustand versetzt wird. Dadurch wird verhindert, dass der Schlüsselcache in der Ruhezustandsdatei vorhanden ist.
Wenn ein Gerät mehrere Silos unterstützt, ist die Authentifizierung durch jedes Silo exklusiv. Ein Authentifizierungsvorgang durch einen Silotreiber wirkt sich nicht auf den Authentifizierungsstatus aus, der von einem anderen Silotreiber festgelegt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorioctl.h (include EhStorIoctl.h) |