IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Les métadonnées associées à une bande sont définies avec une requête IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA. Les métadonnées d’une bande servent de zone de données pour une application de gestionnaire de clés.
Code principal
Mémoire tampon d’entrée
La mémoire tampon d’entrée à Irp->AssociatedIrp.SystemBuffer doit contenir un SET_BAND_METADATA_PARAMETERS et éventuellement une structure AUTH_KEY ainsi que les nouvelles métadonnées à définir pour la bande.
Si le membre AuthKeyOffset de SET_BAND_METADATA_PARAMETERS est défini sur EHSTOR_BANDMGR_NO_KEY, les données d’entrée dans la mémoire tampon système n’ont pas besoin d’inclure une structure AUTH_KEY.
Longueur de la mémoire tampon d’entrée
Parameters.DeviceIoControl.InputBufferLength indique la taille, en octets, de la mémoire tampon, qui doit être au moins sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY).
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 Status :
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Les métadonnées ont été définies pour la bande sélectionnée. |
| STATUS_INVALID_DEVICE_REQUEST | L’appareil 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 est incorrecte. |
| STATUS_INVALID_PARAMETER | Les informations contenues dans la mémoire tampon d’entrée ne sont pas valides. |
| STATUS_NOT_FOUND | La bande n’a pas été trouvée pour les critères de sélection fournis. |
| STATUS_IO_DEVICE_ERROR | Échec de la communication. L’appareil de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
Les métadonnées peuvent également être effacées à l’aide de cette IOCTL. Pour effacer les métadonnées d’une bande, définissez la partie métadonnées de la mémoire tampon d’entrée sur toutes les zéros ou un autre modèle d’effacement. Pour garantir la suppression d’informations sensibles dans les objets blob de métadonnées, cette opération d’effacement doit être effectuée avant de supprimer une bande de la table de bande du pilote de silo.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible dans Windows 8 et versions ultérieures de Windows. |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |