IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL (ehstorbandmgmt.h)
Il IOCTL_EHSTOR_BANDMGMT_ERASE_BAND richiedere la cancellazione crittografica e reimposta la chiave di autenticazione di una banda. La configurazione rimanente della banda viene lasciata non modificata.
Codice principale
Buffer di input
Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere un ERASE_BAND_PARAMETERS e possibilmente una struttura AUTH_KEY.
Se il membro NewAuthKeyOffset di ERASE_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 deve essere almeno sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)
.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Input/Buffer di output
Nessuno.
Lunghezza del buffer di input/output
Nessuno.
Blocco dello stato
Uno dei valori seguenti può essere restituito nel campo Stato .
Valore stato | Descrizione |
---|---|
STATUS_SUCCESS | La band è stata cancellata 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 di cancellazione non è una chiave predefinita e la banda non può essere cancellata. |
STATUS_NOT_FOUND | La band 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
Una chiave di autenticazione di cancellazione corrente non viene fornita in una richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND . La chiave di autenticazione di cancellazione per il dispositivo di archiviazione è configurata in precedenza.
Nessun metodo viene fornito in Windows per modificare la chiave di autenticazione di cancellazione per un dispositivo di archiviazione. Se i parametri corretti vengono forniti come input nel buffer di sistema, questa richiesta deve essere completata. Se la chiave di autenticazione di cancellazione è stata modificata all'esterno di Windows, ad esempio in un ambiente a doppio avvio con un sistema operativo diverso, questa richiesta potrebbe non riuscire.
Quando una band viene cancellata con IOCTL_EHSTOR_BANDMGMT_ERASE_BAND, le uniche proprietà precedenti che rimangono sono le dimensioni della banda iniziale e della banda. La chiave di crittografia multimediale precedente viene rimossa e viene generata una nuova chiave. Il blocco è impostato su PERSISTANT_UNLOCK per la lettura e la scrittura. I metadati di sicurezza impostati in precedenza vengono cancellati. La nuova chiave di autenticazione specificata in ERASE_BAND_PARAMETERS è impostata a meno che non venga indicato l'uso della chiave predefinita.
Per impedire ad altre applicazioni di controllare una banda e cancellare usando la chiave predefinita, è necessario includere una nuova chiave di autenticazione con la richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .
Le modifiche apportate alla tabella band da questa richiesta vengono eseguite con il commit atomico del dispositivo prima del completamento della richiesta IOCTL. Pertanto, è garantito che la banda venga modificata con tutte le relative proprietà impostate o nessuna proprietà impostata su tutti i sistemi o gli errori di alimentazione.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 8 |
Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per