ERASE_BAND_PARAMETERS structure (ehstorbandmgmt.h)
La structure ERASE_BAND_PARAMETERS contient les critères de sélection d’une bande à effacer. En outre, une nouvelle clé d’authentification peut être définie. Cette structure est une entrée pour une demande IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .
Syntaxe
typedef struct _ERASE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Défini sur sizeof(ERASE_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 |
|---|---|
|
La nouvelle clé d’authentification pour cette bande est mise en cache, ce qui permet l’automatisation des opérations ultérieures. |
Reserved
Réservé.
BandId
Identificateur d’une seule bande pour laquelle retourner des informations. BandSize doit être 0 quand 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 des octets sur le périphérique de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe à ou après BandStart.
NewAuthKeyOffset
Décalage, en octets, d’une structure de AUTH_KEY contenant la nouvelle clé d’autorisation pour la bande. Le décalage est du début de ERASE_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é à la clé. Si KeySize a la valeur 0, une clé par défaut est utilisée.
Clé :
Tableau d’octets de longueur variable qui contient les données de clé.
Pour spécifier une clé d’authentification par défaut pour la bande, définissez NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
Remarques
La priorité est accordé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ée dans le bloc IoStatus pour IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.
.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |