Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 corrispondenza di Irp->AssociatedIrp.SystemBuffer deve contenere un DELETE_BAND_PARAMETERS ed eventualmente una struttura AUTH_KEY.
Se il membro di DELETE_BAND_PARAMETERS AuthKeyOffset è 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 di stato
È possibile restituire uno dei valori seguenti nel campo Stato.
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | Il gruppo è stato eliminato correttamente. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | Le dimensioni del buffer di input non sono corrette. |
| 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. |
Osservazioni
È necessaria una chiave di autenticazione per eliminare una banda senza prima eseguire una cancellazione. Per richiedere la cancellazione di una banda, il flag di DELBAND_ERASE_BEFORE_DELETE viene impostato nel membro flag di DELETE_BAND_PARAMETERS.
Dopo l'eliminazione di una band, tutti gli LBA contenuti nella banda eliminata vengono restituiti alla banda globale. Le condizioni di blocco per la banda globale ora si applicano agli LBA restituiti alla banda globale. I LBA restituiti alla banda globale sono ora associati alla chiave multimediale per la banda globale e i dati crittografati in tali LBA non sono irreversibili.
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. È possibile creare successivamente 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 di 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.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile a partire da Windows 8. |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |