Share via


IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)

Die IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS Anforderung löscht die Authentifizierungsschlüssel für alle konfigurierten Bänder kryptografisch und setzt sie zurück.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Keine.

Eingabepufferlänge

Keine.

Ausgabepuffer

Keine.

Länge des Ausgabepuffers

Keine.

Eingabe-/Ausgabepuffer

Keine.

Länge des Eingabe-/Ausgabepuffers

Keine.

Statusblock

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

Statuswert BESCHREIBUNG
STATUS_SUCCESS Alle Bänder wurden erfolgreich gelöscht.
STATUS_INVALID_DEVICE_REQUEST Das Speichergerät unterstützt keine Bandverwaltung.
STATUS_IO_DEVICE_ERROR Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel.

Hinweise

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS löscht und setzt den Authentifizierungsschlüssel für jedes konfigurierte Band auf dem Speichergerät ein Band nach dem anderen zurück. Wenn alle konfigurierten Bänder erfolgreich gelöscht wurden, gibt die IOCTL eine erfolgreiche status zurück. Wenn das Löschen für mindestens ein konfiguriertes Band fehlschlägt, gibt die IOCTL den Fehler status aus dem ersten konfigurierten Band zurück, für das ein Fehler aufgetreten ist. In diesem Fall sollte ein Client auf den Aufruf IOCTL_EHSTOR_BANDMGMT_ERASE_BAND für jedes konfigurierte Band zurückgreifen.

Es gibt keine Garantie für die Atomizität für das Löschen über mehrere konfigurierte Bänder. Wenn also während der Verarbeitung dieser IOCTL ein System- oder Stromausfall auftritt, wurden einige konfigurierte Bänder möglicherweise erfolgreich gelöscht, während andere nicht.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 22H2
Kopfzeile ehstorbandmgmt.h

Weitere Informationen

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND