IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS IOCTL (ehstorbandmgmt.h)
La IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS demande de manière de chiffrement efface et réinitialise les clés d’authentification pour toutes les bandes configurées.
Code principal
Mémoire tampon d’entrée
Aucun.
Longueur de la mémoire tampon d’entrée
Aucun.
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Mémoire tampon d’entrée/sortie
Aucun.
Longueur de la mémoire tampon d’entrée/sortie
Aucun.
Bloc d’état
L’une des valeurs suivantes peut être retournée dans le champ Status.
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Toutes les bandes ont été effacées avec succès. |
| STATUS_INVALID_DEVICE_REQUEST | L’appareil de stockage ne prend pas en charge la gestion des bandes. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. L’appareil de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
IOCTL_EHSTOR_BANDMGMT_ERASE_ALL_BANDS efface et réinitialise la clé d’authentification pour chaque bande configurée sur l’appareil de stockage, une bande à la fois. Si toutes les bandes configurées sont effacées avec succès, le IOCTL retourne un état de réussite. Si l’effacement échoue pour une ou plusieurs bandes configurées, le IOCTL retourne l’état d’échec de la première bande configurée pour laquelle une erreur s’est produite. Dans ce cas, un client doit revenir à l’appel de IOCTL_EHSTOR_BANDMGMT_ERASE_BAND pour chaque bande configurée.
Il n’existe aucune garantie d’atomicité fournie pour l’effacement entre plusieurs bandes configurées. Par conséquent, si un système ou une panne d’alimentation se produit pendant que ce IOCTL est en cours de traitement, certaines bandes configurées ont peut-être été effacées avec succès, tandis que d’autres peuvent ne pas avoir.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 11, version 22H2 |
| d’en-tête | ehstorbandmgmt.h |