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