structure SET_BAND_SECURITY_PARAMETERS (ehstorbandmgmt.h)
Les paramètres permettant de définir les propriétés de sécurité d’une bande sur un périphérique de stockage pour une demande de IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY sont spécifiés dans une structure de SET_BAND_SECURITY_PARAMETERS .
Syntaxe
typedef struct _SET_BAND_SECURITY_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG CurrentAuthKeyOffset;
ULONG NewAuthKeyOffset;
ULONG BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;
Membres
StructSize
Taille de cette structure en octets. Définissez sur sizeof(SET_BAND_SECURITY_PARAMETERS).
Flags
Indicateurs de paramètres de sécurité. Cette valeur est une combinaison OR au niveau du bit des éléments suivants.
| Valeur | Signification |
|---|---|
|
La nouvelle clé d’authentification peut être mise en cache pour automatiser certaines opérations de bande. |
Reserved
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.
CurrentAuthKeyOffset
Décalage, en octets, d’une structure AUTH_KEY contenant la clé d’authentification actuelle pour la bande. Cette clé d’authentification est obligatoire et doit être présente en suivant cette structure. Le décalage est à partir du début de SET_BAND_SECURITY_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.
NewAuthKeyOffset
Décalage, en octets, d’une structure AUTH_KEY contenant la nouvelle clé d’authentification pour la bande. Le décalage est à partir du début de SET_BAND_SECURITY_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 qui contient les données clés.
Pour affecter une clé d’authentification par défaut à la bande, définissez AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Si NewAuthKeyOffset == CurrentAuthKeyOffset, la clé d’authentification de la bande reste inchangée.
BandSecurityInfoOffset
Décalage, en octets, d’une structure BAND_SECURITY_INFO . Le décalage est à partir du début de SET_BAND_SECURITY_PARAMETERS.
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_SET_BAND_SECURITY.
Si BandID et BandStart sont tous deux définis sur –1, la demande IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY modifie les propriétés de la bande globale.
NewAuthKeyOffset et BandSecurityInfoOffset sont facultatifs en fonction des exigences de l’opération. Si seule la clé d’authentification est modifiée, NewAuthKeyOffset est défini sur l’emplacement de la structure AUTH_KEY pour la nouvelle clé et BandSecurityInfoOffset est défini sur zéro. De même, si seules les propriétés de sécurité sont modifiées, BandSecurityInfoOffset est défini sur l’emplacement de BAND_SECURITY_INFO et NewAuthKeyOffset a la valeur 0.
Les membres CryptoAlgoIdType et CryptoAlgoOidString de la structure BAND_SECURITY_INFO sur BandSecurityInfoOffset ne sont pas utilisés dans une demande de création de bande et doivent être définis sur 0.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 8 |
| En-tête | ehstorbandmgmt.h (inclure EhStorBandMgmt.h) |