structure DELETE_BAND_PARAMETERS (ehstorbandmgmt.h)
Une bande configurée est supprimée en fonction des paramètres d’une structure de DELETE_BAND_PARAMETERS . Cette structure est une entrée pour une demande de IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .
Syntaxe
typedef struct _DELETE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Définissez sur sizeof(DELETE_BAND_PARAMETERS).
Flags
Supprimer les indicateurs d’opération. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.
Valeur | Signification |
---|---|
|
Effectuez une effacement de chiffrement des données de propriété de la bande avant la suppression. |
Reserved
Réservé.
BandId
Identificateur d’une seule bande pour laquelle retourner des informations. BandSize doit être 0 lorsqu’une seule bande est sélectionnée avec BandId. Pour utiliser BandStart et BandSize au lieu de BandId pour sélectionner une bande, définissez BandId = (ULONG) –1.
BandStart
Emplacement de début d’octet sur l’appareil de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre une bande à ou après BandStart.
AuthKeyOffset
Décalage, en octets, d’une structure AUTH_KEY contenant la clé d’autorisation pour la bande. Le décalage est à partir du début de DELETE_BAND_PARAMETERS. AUTH_KEY est déclaré dans ehstorbandmgmt.h comme suit.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
KeySize
Taille de la clé, en octets, des données de clé sur Clé. Si KeySize a la valeur 0, une clé par défaut est utilisée.
Clé :
Tableau d’octets de longueur variable contenant les données clés.
Pour spécifier une clé d’authentification par défaut pour la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Si Flags contient DELBAND_ERASE_BEFORE_DELETE, AuthKeyOffset doit être défini sur EHSTOR_BANDMGR_NO_KEY.
Remarques
La priorité est donnée à BandID pour la sélection de la bande. Si BandID est supérieur à 0 et que BandID est inférieur au membre MaxBandCount de BAND_MANAGEMENT_CAPABILITIES, bandID est utilisé comme seul critère de sélection pour une correspondance de bande. Si BandID == –1, BandStart est utilisé comme critère de correspondance pour sélectionner une bande. Si aucune bande ne correspond à l’un ou l’autre des critères de sélection, STATUS_INVALID_PARAMETER est retourné dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.
Si DELBAND_ERASE_BEFORE_DELETE est défini dans Indicateurs, une clé d’authentification n’est pas nécessaire pour supprimer la bande. Si cet indicateur n’est pas défini, la clé d’authentification actuelle doit être incluse dans AuthKeyOffset.
.
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Disponible à partir de Windows 8 |
En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |
Voir aussi
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour