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 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éfini sur taille de(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 bande unique 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 un groupe, définissez BandId = (ULONG) –1.
BandStart
Emplacement d’octet de départ sur l’appareil de stockage pour commencer une recherche de bande. Une tentative est effectuée pour faire correspondre un groupe au 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 requise et doit être présente à la suite de cette structure. Le décalage est 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é à 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 sur 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 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é à 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 du début de SET_BAND_SECURITY_PARAMETERS.
Remarques
La priorité est donnée à id de bande pour la sélection de bande. Si BandID est supérieur à 0 et 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ères de correspondance pour sélectionner une bande. Si aucune bande ne correspond à l’un des critères de sélection, STATUS_INVALID_PARAMETER est retournée 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éfinie sur l’emplacement de la structure de AUTH_KEY pour la nouvelle clé et BandSecurityInfoOffset a la valeur zéro. De même, si seules les propriétés de sécurité sont modifiées, bandSecurityInfoOffset est définie sur l’emplacement de BAND_SECURITY_INFO et NewAuthKeyOffset est défini sur 0.
Les CryptoAlgoIdType et CryptoAlgoOidString membres de la structure BAND_SECURITY_INFO à BandSecurityInfoOffset ne sont pas utilisés dans une demande de création de bande et doivent être définis sur 0.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8 |
| d’en-tête | ehstorbandmgmt.h (include EhStorBandMgmt.h) |