IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
Die IOCTL_EHSTOR_BANDMGMT_ERASE_BAND Anforderung löscht kryptografisch und setzt den Authentifizierungsschlüssel eines Bandes zurück. Die verbleibende Konfiguration des Bandes bleibt unverändert.
Hauptcode
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_KEYfestgelegt 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(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)sein muss.
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 | Das 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 | Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
Bemerkungen
Ein aktueller Löschauthentifizierungsschlüssel wird in einer IOCTL_EHSTOR_BANDMGMT_ERASE_BAND Anforderung nicht bereitgestellt. Der Radierauthentifizierungsschlüssel für das Speichergerät ist zuvor konfiguriert.
In Windows wird keine Methode zum Ändern des Radierauthentifizierungsschlü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, schlägt diese Anforderung möglicherweise fehl.
Wenn ein Band mit IOCTL_EHSTOR_BANDMGMT_ERASE_BANDgelöscht wird, sind die einzigen vorherigen Eigenschaften, die bandanfangs- und bandgröße bleiben. Der vorherige Medienverschlüsselungsschlüssel wird entfernt und ein neuer Schlüssel wird generiert. Die Sperrung ist für lese- und schreibvorgänge auf PERSISTANT_UNLOCK festgelegt. Zuvor festgelegte Sicherheitsmetadaten werden gelöscht. Der in ERASE_BAND_PARAMETERS angegebene neue Authentifizierungsschlüssel wird festgelegt, es sei denn, der Standardschlüssel wird verwendet.
Um zu verhindern, dass andere Anwendungen die Kontrolle über ein Band übernehmen und mit dem Standardschlüssel löschen, sollte ein neuer Authentifizierungsschlüssel in die IOCTL_EHSTOR_BANDMGMT_ERASE_BAND Anforderung aufgenommen werden.
Die Änderungen, die an der Bandtabelle dieser Anforderung vorgenommen wurden, werden dem Gerät atomisch zugesichert, bevor die IOCTL-Anforderung abgeschlossen ist. Daher wird sichergestellt, dass das Band mit allen eigenschaften festgelegt oder überhaupt keine Eigenschaften festgelegt wird, wenn ein System- oder Stromausfall auftritt.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8 |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |