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 On-Demand-Authentifizierung oder -deauthentication zu initiieren.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer muss eine AUTHZ_STATE Struktur enthalten, die den auszuführenden Authentifizierungsvorgangstyp 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 | Ausführen der On-Demand-Deauthentication. |
| AUTHZSTATE_AUTHENTICATE | Führen Sie die On-Demand-Authentifizierung aus. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Führen Sie die On-Demand-Deauthentication durch, und löschen Sie zwischengespeicherte Authentifizierungsschlüssel. |
Eingabepufferlänge
Die Länge einer AUTHZ_STATE Struktur.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
STATUS_SUCCESS wird vom Silotreiber im Feld Status zurückgegeben, wenn der Authentifizierungsstatus geändert wird. Andernfalls wird STATUS_UNSUCCESSFUL zurückgegeben.
Bemerkungen
Diese IOCTL wird von EHSTOR an einen Silotreiber gesendet, der die On-Demand-Authentifizierung unterstützt. Der Silotreiber benachrichtigt EHSTOR über diese Funktion in einer vorherigen IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES Anforderung mit dem CAP_ON_DEMAND_AUTHENTICATION Flag, das im Capabilities Mitglied von SILO_DRIVER_CAPABILITESfestgelegt ist.
Als Reaktion auf diese IOCTL führt der Silotreiber Authentifizierung oder Deauthentication für das Gerät durch. Bei gebänderten Geräten wird der Silotreiber je nach dem angegebenen Vorgang im Systempuffer so viele Bänder wie möglich für Lese- und Schreibvorgänge entsperren oder sperren.
Wenn der Silotreiber den angeforderten Vorgang nicht ausführt, ändert er den Authentifizierungsstatus eines Geräts nicht.
Wenn das AuthzState Mitglied von AUTHZ_STATE auf AUTHZSTATE_CLEAR_AUTHKEY_CACHEfestgelegt ist, löscht der Silotreiber den Authentifizierungsschlüsselcache zusätzlich zur Deauthentisierung. AUTHZSTATE_CLEAR_AUTHKEY_CACHE wird festgelegt, wenn das System heruntergefahren oder ruhet. Dadurch wird verhindert, dass der Schlüsselcache in der Ruhezustandsdatei vorhanden ist.
Wenn ein Gerät mehrere Silos unterstützt, ist die Authentifizierung durch jeden Silo exklusiv. Ein Authentifizierungsvorgang durch einen Silotreiber wirkt sich nicht auf den Authentifizierungszustand aus, der von einem anderen Silotreiber festgelegt wurde.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8 |
| Header- | ehstorioctl.h (einschließlich EhStorIoctl.h) |