IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL (ehstorbandmgmt.h)
Cette IOCTL_EHSTOR_BANDMGMT_REVERT demande est envoyée pour désactiver les fonctionnalités de sécurité et la gestion des bandes sur un périphérique de stockage. La demande inclut les options de restauration et la clé d’authentification.
Code principal
Mémoire tampon d'entrée
La mémoire tampon d’entrée dans Irp-AssociatedIrp.SystemBuffer> contient une structure ACTIVATE_REVERT_PARAMETERS. ACTIVATE_REVERT_PARAMETERS est déclaré dans ehstorbandmgmt.h comme suit.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
La ACTIVATE_REVERT_PARAMETERS suivante dans la mémoire tampon système est une structure AUTH_KEY. Cette propriété contient les octets de données de clé pour la clé d’authentification. AUTH_KEY est déclaré dans ehstorbandmgmt.h comme suit.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Longueur de la mémoire tampon d’entrée
Longueur d’une structure de ACTIVATE_REVERT_PARAMETERS .
Mémoire tampon de sortie
Aucun.
Longueur de la mémoire tampon de sortie
Aucun.
Bloc d’état
L’une des valeurs suivantes peut être retournée dans le champ État .
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Les fonctionnalités de sécurité sur le périphérique de stockage ont été désactivées. |
| STATUS_INVALID_DEVICE_REQUEST | Le périphérique de stockage ne prend pas en charge la gestion des bandes. |
| STATUS_INVALID_BUFFER_SIZE | La taille de la mémoire tampon d’entrée n’est pas valide. |
| STATUS_INVALID_PARAMETER | Les informations contenues dans la mémoire tampon d’entrée ne sont pas valides. |
| STATUS_ACCESS_DENIED | La clé d’authentification n’est pas valide. La désactivation est refusée. |
| STATUS_DEVICE_CONFIGURATION_ERROR | Le système ne peut pas configurer l’appareil en mode pris en charge. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité. |
| STATUS_INVALID_DEVICE_STATE | Le périphérique de stockage n’est pas activé. |
Remarques
À un retour réussi à partir d’une demande de IOCTL_EHSTOR_BANDMGMT_REVERT , le périphérique de stockage retourne à un état de sécurité inactif et tous les IOCTL de gestion des bandes, à l’exception des IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES et des IOCTL_EHSTOR_BANDMGMT_ACTIVATE, deviennent indisponibles.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |