IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)

Artikel
02/06/2025

Diese IOCTL_EHSTOR_BANDMGMT_REVERT Anforderung wird gesendet, um die Sicherheitsfeatures und die Bandverwaltung auf einem Speichergerät zu deaktivieren. Die Anforderung enthält Revert-Optionen und den Authentifizierungsschlüssel.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält eine ACTIVATE_REVERT_PARAMETERS Struktur. ACTIVATE_REVERT_PARAMETERS wird in ehstorbandmgmt.h wie folgt deklariert.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

Das Folgen ACTIVATE_REVERT_PARAMETERS im Systempuffer ist eine AUTH_KEY Struktur. Dies enthält die Schlüsseldatenbytes für den Authentifizierungsschlüssel. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

Eingabepufferlänge

Die Länge einer ACTIVATE_REVERT_PARAMETERS Struktur.

Ausgabepuffer

Nichts.

Länge des Ausgabepuffers

Nichts.

Statusblock

Einer der folgenden Werte kann im Feld Status zurückgegeben werden.

Statuswert	Beschreibung
STATUS_SUCCESS	Sicherheitsfeatures auf dem Speichergerät wurden deaktiviert.
STATUS_INVALID_DEVICE_REQUEST	Das Speichergerät unterstützt keine Bandverwaltung.
STATUS_INVALID_BUFFER_SIZE	Die Größe des Eingabepuffers ist ungültig.
STATUS_INVALID_PARAMETER	Die Informationen im Eingabepuffer sind ungültig.
STATUS_ACCESS_DENIED	Der Authentifizierungsschlüssel ist ungültig. Die Deaktivierung wird verweigert.
STATUS_DEVICE_CONFIGURATION_ERROR	Das System kann das Gerät nicht in einem unterstützten Modus konfigurieren.
STATUS_IO_DEVICE_ERROR	Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel.
STATUS_INVALID_DEVICE_STATE	Das Speichergerät ist nicht aktiviert.

Bemerkungen

Bei erfolgreicher Rückgabe von einer IOCTL_EHSTOR_BANDMGMT_REVERT Anforderung kehrt das Speichergerät zu einem inaktiven Sicherheitsstatus zurück, und alle IoCTLs der Bandverwaltung, mit Ausnahme von IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES und IOCTL_EHSTOR_BANDMGMT_ACTIVATE, sind nicht verfügbar.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8
Header-	ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h)

Siehe auch

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

Freigeben über