Condividi tramite


IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)

Il IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS richiedere la cancellazione crittografica e la reimpostazione delle chiavi di autenticazione per tutte le bande configurate.

Codice principale

IRP_MJ_DEVICE_CONTROL

Buffer di input

Nessuno.

Lunghezza del buffer di input

Nessuno.

Buffer di output

Nessuno.

Lunghezza del buffer di output

Nessuno.

Buffer di input/output

Nessuno.

Lunghezza del buffer di input/output

Nessuno.

Blocco di stato

È possibile restituire uno dei valori seguenti nel campo Stato.

Valore di stato Descrizione
STATUS_SUCCESS Tutte le bande sono state cancellate con successo.
STATUS_INVALID_DEVICE_REQUEST Il dispositivo di archiviazione non supporta la gestione della banda.
STATUS_IO_DEVICE_ERROR Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza.

Osservazioni

IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS cancella e reimposta in modo crittografico la chiave di autenticazione per ogni banda configurata nel dispositivo di archiviazione, una banda alla volta. Se tutte le bande configurate vengono cancellate correttamente, L'IOCTL restituirà uno stato di esito positivo. Se la cancellazione ha esito negativo per una o più band configurate, IOCTL restituirà lo stato di errore dalla prima banda configurata per cui si è verificato un errore. In questo caso, un client deve eseguire il fallback alla chiamata di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND per ogni banda configurata.

Non esiste alcuna garanzia di atomicità fornita per la cancellazione tra più bande configurate. Pertanto, se si verifica un sistema o un guasto di alimentazione durante l'elaborazione di questo IOCTL, alcune bande configurate potrebbero essere state cancellate correttamente mentre altre potrebbero non avere.

Fabbisogno

Requisito Valore
client minimo supportato Windows 11, versione 22H2
intestazione ehstorbandmgmt.h

Vedere anche

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND