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
SETBANDSEC_AUTHKEY_CACHING_ENABLED	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)

Voir aussi

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION