IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
O IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS solicitação apaga criptograficamente e redefine as chaves de autenticação para todas as bandas configuradas.
Código principal
Buffer de entrada
Nenhum.
Comprimento do buffer de entrada
Nenhum.
Buffer de saída
Nenhum.
Comprimento do buffer de saída
Nenhum.
Buffer de entrada/saída
Nenhum.
Comprimento do buffer de entrada/saída
Nenhum.
Bloco de status
Um dos valores a seguir pode ser retornado no campo status do.
| Valor do status | Descrição |
|---|---|
| STATUS_SUCCESS | Todas as bandas foram apagadas com êxito. |
| STATUS_INVALID_DEVICE_REQUEST | O dispositivo de armazenamento não dá suporte ao gerenciamento de banda. |
| STATUS_IO_DEVICE_ERROR | Falha na comunicação. O dispositivo de armazenamento pode ser incompatível com protocolos de segurança. |
Observações
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS apaga criptograficamente e redefine a chave de autenticação para cada banda configurada no dispositivo de armazenamento, uma banda por vez. Se todas as bandas configuradas forem apagadas com êxito, o IOCTL retornará um status de sucesso. Se a apagamento falhar para uma ou mais bandas configuradas, o IOCTL retornará o status de falha da primeira banda configurada para a qual ocorreu um erro. Nesse caso, um cliente deve voltar a chamar IOCTL_EHSTOR_BANDMGMT_ERASE_BAND para cada banda configurada.
Não há nenhuma garantia de atomicidade fornecida para apagamento em várias bandas configuradas. Portanto, se ocorrer uma falha de energia ou sistema enquanto este IOCTL estiver sendo processado, algumas bandas configuradas poderão ter sido apagadas com êxito, enquanto outras podem não ter.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 11, versão 22H2 |
| cabeçalho | ehstorbandmgmt.h |