IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)

Die IOCTL_EHSTOR_BANDMGMT_ERASE_BAND Anforderung löscht den Authentifizierungsschlüssel eines Bandes kryptografisch und setzt diesen zurück. Die verbleibende Konfiguration des Bandes bleibt unverändert.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der Eingabepuffer bei Irp-AssociatedIrp.SystemBuffer> muss eine ERASE_BAND_PARAMETERS und möglicherweise eine AUTH_KEY-Struktur enthalten.

Wenn das NewAuthKeyOffset-Element von ERASE_BAND_PARAMETERS auf EHSTOR_BANDMGR_NO_KEY festgelegt ist, müssen die Eingabedaten im Systempuffer keine AUTH_KEY-Struktur enthalten.

Länge des Eingabepuffers

Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes an, die mindestens sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)sein muss.

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	Die Band wurde erfolgreich gelöscht.
STATUS_INVALID_DEVICE_REQUEST	Das Speichergerät unterstützt keine Bandverwaltung.
STATUS_INVALID_BUFFER_SIZE	Die Größe des Eingabepuffers ist falsch.
STATUS_INVALID_PARAMETER	Die Informationen im Eingabepuffer sind ungültig.
STATUS_ACCESS_DENIED	Der Löschauthentifizierungsschlüssel ist kein Standardschlüssel, und das Band kann nicht gelöscht werden.
STATUS_NOT_FOUND	Das Band wurde für die angegebenen Auswahlkriterien nicht gefunden.
STATUS_IO_DEVICE_ERROR	Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel.

Hinweise

Ein aktueller Löschauthentifizierungsschlüssel wird in einer IOCTL_EHSTOR_BANDMGMT_ERASE_BAND-Anforderung nicht bereitgestellt. Der Löschauthentifizierungsschlüssel für das Speichergerät wurde zuvor konfiguriert.

In Windows wird keine Methode zum Ändern des Löschauthentifizierungsschlüssels für ein Speichergerät bereitgestellt. Sofern die richtigen Parameter als Eingabe im Systempuffer angegeben werden, sollte diese Anforderung erfolgreich sein. Wenn der Löschauthentifizierungsschlüssel außerhalb von Windows geändert wurde, z. B. in einer Dual-Boot-Umgebung mit einem anderen Betriebssystem, kann diese Anforderung fehlschlagen.

Wenn ein Band mit IOCTL_EHSTOR_BANDMGMT_ERASE_BAND gelöscht wird, sind die einzigen vorherigen Eigenschaften, die übrig bleiben, Bandstart und Bandgröße. Der vorherige Medienverschlüsselungsschlüssel wird entfernt, und ein neuer Schlüssel wird generiert. Die Sperrung ist auf PERSISTANT_UNLOCK für Lese- und Schreibvorgänge festgelegt. Zuvor festgelegte Sicherheitsmetadaten werden gelöscht. Der in ERASE_BAND_PARAMETERS angegebene neue Authentifizierungsschlüssel wird festgelegt, es sei denn, es wird der Standardschlüssel verwendet.

Um zu verhindern, dass andere Anwendungen die Kontrolle über ein Band übernehmen und mithilfe des Standardschlüssels löschen, sollte ein neuer Authentifizierungsschlüssel in die IOCTL_EHSTOR_BANDMGMT_ERASE_BAND-Anforderung eingeschlossen werden.

Die von dieser Anforderung an der Bandtabelle vorgenommenen Änderungen werden atomar an das Gerät committet, bevor die IOCTL-Anforderung abgeschlossen wird. Daher wird garantiert, dass das Band geändert wird, wobei alle Eigenschaften festgelegt sind, oder dass keine Eigenschaften festgelegt werden, wenn ein System- oder Stromausfall auftritt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Kopfzeile	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Weitere Informationen

ERASE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS