Partager via

IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

  • Article

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

IRP_MJ_DEVICE_CONTROL

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)

Voir aussi

SET_BAND_METADATA_PARAMETERS