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 sur Irp-AssociatedIrp.SystemBuffer> doit contenir une SET_BAND_METADATA_PARAMETERS et éventuellement une structure de 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 État :
| Valeur d’état | Description |
|---|---|
| STATUS_SUCCESS | Les métadonnées ont été définies pour la bande sélectionnée. |
| 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 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. Le périphérique de stockage peut être incompatible avec les protocoles de sécurité. |
Remarques
Les métadonnées peuvent également être effacées à l’aide de ce 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 tous les zéros ou sur un autre modèle d’effacement. Pour garantir la suppression des 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows 8 et versions ultérieures de Windows. |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |