IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)

Ein konfiguriertes Band auf einem Speichergerät wird mit der IOCTL_EHSTOR_BANDMGMT_DELETE_BAND-Anforderung gelöscht. Eine Löschoption in den Eingabeparametern ermöglicht es der Anforderung, eine kryptografische Löschung der Banddaten durchzuführen.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

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

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

Eingabepufferlänge

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

Ausgabepuffer

Keine.

Länge des 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 Authentifizierungsschlüssel ist ungültig, oder das Band ist für das Schreiben gesperrt.
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 Authentifizierungsschlüssel ist erforderlich, um ein Band zu löschen, ohne zuerst eine Löschung durchzuführen. Um eine Bandlöschung anzufordern, wird das DELBAND_ERASE_BEFORE_DELETE-Flag im Flags-Element von DELETE_BAND_PARAMETERS festgelegt.

Nach einem Bandlöschen werden alle im gelöschten Band enthaltenen LBAs an das globale Band zurückgegeben. Die Sperrbedingungen für das globale Band gelten nun für die lbAs, die an das globale Band zurückgegeben werden. Die in das globale Band zurückgegebenen LBAs sind nun mit dem Medienschlüssel für das globale Band verknüpft, und verschlüsselte Daten in diesen LBAs sind nicht wiederhergestellt.

Das gelöschte Band verbleibt in der Bandtabelle des Silotreibers, wird aber nicht konfiguriert. Der Authentifizierungsschlüssel wird auf den Standardwert zurückgesetzt, Band- und Schlüsselmetadaten enthalten Nullen, und die Sperrzustände rückgängig machen auf PERSISTENT_UNLOCK. Das Band ist jetzt für die Neukonfiguration mit einer IOCTL_EHSTOR_BANDMGMT_CREATE_BAND-Anforderung verfügbar.

Wenn Sie ein Band ohne kryptografische Löschung löschen, wird der Verschlüsselungsschlüssel für dieses Band nicht entfernt. Es ist möglich, später ein Band mit der gleichen Konfiguration und Bandbezeichner wie das gelöschte Band zu erstellen. In diesem Fall sind Daten, die zuvor im Band gespeichert und nicht überschrieben wurden, da die Löschung des vorherigen Bandes verfügbar ist. Um diese Situation zu vermeiden, löschen Sie das Band mit dem in DELETE_BAND_PARAMETERS festgelegten DELBAND_ERASE_BEFORE_DELETE-Flag.

Die IOCTL_EHSTOR_BANDMGMT_DELETE_BAND löscht das globale Band nicht. Eine Anforderung dazu gibt STATUS_INVALID_PARAMETER zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 8.
Kopfzeile	ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h)

Weitere Informationen

DELETE_BAND_PARAMETERS

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND