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
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) |