IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
Die IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS Anforderung löscht kryptografisch und setzt die Authentifizierungsschlüssel für alle konfigurierten Bänder zurück.
Hauptcode
Eingabepuffer
Nichts.
Eingabepufferlänge
Nichts.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Eingabe-/Ausgabepuffer
Nichts.
Länge des Eingabe-/Ausgabepuffers
Nichts.
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 | Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
Bemerkungen
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS kryptografisch löscht und setzt den Authentifizierungsschlüssel für jedes konfigurierte Band auf dem Speichergerät um jeweils ein Band zurück. Wenn alle konfigurierten Bänder erfolgreich gelöscht werden, gibt die IOCTL einen Erfolgsstatus zurück. Wenn das Löschen für einen oder mehrere konfigurierte Bande fehlschlägt, gibt die IOCTL den Fehlerstatus aus dem ersten konfigurierten Band zurück, für den 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 Atomitätsgarantie für die Löschung über mehrere konfigurierte Bänder hinweg. Wenn also ein System- oder Stromausfall auftritt, während dieses IOCTL verarbeitet wird, wurden einige konfigurierte Bänder möglicherweise erfolgreich gelöscht, während andere möglicherweise nicht vorhanden sind.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 11, Version 22H2 |
| Header- | ehstorbandmgmt.h |