IOCTL_EHSTOR_BANDMGMT_DELETE_BAND IOCTL (ehstorbandmgmt.h)
Una banda configurata in un dispositivo di archiviazione viene eliminata con la richiesta di IOCTL_EHSTOR_BANDMGMT_DELETE_BAND . Un'opzione di cancellazione nei parametri di input consente alla richiesta di eseguire una cancellazione crittografica dei dati della banda.
Codice principale
Buffer di input
Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere un DELETE_BAND_PARAMETERS ed eventualmente una struttura AUTH_KEY.
Se il membro AuthKeyOffset di DELETE_BAND_PARAMETERS è impostato su EHSTOR_BANDMGR_NO_KEY, i dati di input nel buffer di sistema non devono includere una struttura AUTH_KEY .
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof (DELETE_BAND_PARAMETERS) + sizeof(AUTH_KEY).
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
È possibile restituire uno dei valori seguenti nel campo Stato .
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | La band è stata eliminata correttamente. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | La dimensione del buffer di input non è corretta. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_ACCESS_DENIED | La chiave di autenticazione non è valida o la banda è bloccata per la scrittura. |
| STATUS_NOT_FOUND | La banda non è stata trovata per i criteri di selezione specificati. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
Commenti
È necessaria una chiave di autenticazione per eliminare una banda senza prima eseguire una cancellazione. Per richiedere la cancellazione di una banda, il flag DELBAND_ERASE_BEFORE_DELETE viene impostato nel membro Flags di DELETE_BAND_PARAMETERS.
Dopo l'eliminazione di una band, tutti gli LBA contenuti nella band eliminata vengono restituiti alla band globale. Le condizioni di blocco per la banda globale ora si applicano agli LBA restituiti alla banda globale. Gli LBA restituiti alla banda globale sono ora associati alla chiave multimediale per la banda globale e i dati crittografati in tali LBA non sono recuperabili.
La banda eliminata rimane nella tabella band del driver silo, ma diventa non configurata. La chiave di autenticazione viene reimpostata sul valore predefinito, i metadati della banda e della chiave contengono zeri e gli stati di blocco ripristinano PERSISTENT_UNLOCK. La banda è ora disponibile per la riconfigurazione con una richiesta di IOCTL_EHSTOR_BANDMGMT_CREATE_BAND .
L'eliminazione di una banda senza una cancellazione crittografica non rimuoverà la chiave di crittografia per tale banda. In seguito è possibile creare una banda con la stessa configurazione e lo stesso identificatore di banda della banda eliminata. In questo caso, i dati archiviati in precedenza nella banda e non sovrascritti perché l'eliminazione della banda precedente sarà disponibile. Per evitare questa situazione, eliminare la banda con il flag DELBAND_ERASE_BEFORE_DELETE impostato in DELETE_BAND_PARAMETERS.
Il IOCTL_EHSTOR_BANDMGMT_DELETE_BAND non eliminerà la banda globale. Una richiesta a tale scopo restituirà STATUS_INVALID_PARAMETER.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8. |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |