struttura SET_BAND_SECURITY_PARAMETERS (ehstorbandmgmt.h)

I parametri per impostare le proprietà di sicurezza per una banda in un dispositivo di archiviazione per una richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY vengono specificati in una struttura SET_BAND_SECURITY_PARAMETERS .

Sintassi

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;

Members

StructSize

La dimensione di questa struttura in byte. Impostare su sizeof(SET_BAND_SECURITY_PARAMETERS).

Flags

Flag dei parametri di sicurezza. Questo valore è una combinazione OR bit per bit della seguente.

Valore	Significato
SETBANDSEC_AUTHKEY_CACHING_ENABLED	La nuova chiave di autenticazione può essere memorizzata nella cache per automatizzare alcune operazioni di banda.

Reserved

BandId

Identificatore di una singola banda per cui restituire informazioni. BandSize deve essere 0 quando viene selezionata una singola banda con BandId. Per usare BandStart e BandSize anziché BandId per selezionare una band, impostare BandId = (ULONG) -1.

BandStart

Posizione dei byte iniziale nel dispositivo di archiviazione per avviare una ricerca di banda. Viene effettuato un tentativo di trovare una corrispondenza con una band all'indirizzo o dopo BandStart.

CurrentAuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY contenente la chiave di autenticazione corrente per la banda. Questa chiave di autenticazione è obbligatoria e deve essere presente seguendo questa struttura. L'offset si trova dall'inizio di SET_BAND_SECURITY_PARAMETERS. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Dimensioni della chiave, in byte, dei dati della chiave in Chiave. Se KeySize è impostato su 0, viene usata una chiave predefinita.

Chiave

Matrice di byte a lunghezza variabile contenente i dati chiave.

Per specificare una chiave di autenticazione predefinita per la banda, impostare AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.

NewAuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY contenente la nuova chiave di autenticazione per la banda. L'offset si trova dall'inizio di SET_BAND_SECURITY_PARAMETERS. AUTH_KEY viene dichiarato in ehstorbandmgmt.h come indicato di seguito.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Dimensioni della chiave, in byte, dei dati della chiave in Chiave. Se KeySize è impostato su 0, viene usata una chiave predefinita.

Chiave

Matrice di byte a lunghezza variabile che contiene i dati chiave.

Per assegnare una chiave di autenticazione predefinita alla banda, impostare AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Se NewAuthKeyOffset == CurrentAuthKeyOffset, la chiave di autenticazione per la banda rimane invariata.

BandSecurityInfoOffset

Offset, in byte, di una struttura BAND_SECURITY_INFO . L'offset si trova dall'inizio di SET_BAND_SECURITY_PARAMETERS.

Commenti

La precedenza viene assegnata a BandID per la selezione della banda. Se BandID è maggiore di 0 e BandID è minore del membro MaxBandCount di BAND_MANAGEMENT_CAPABILITIES, BandID viene usato come unico criterio di selezione per una corrispondenza di banda. Se BandID == –1, BandStart viene usato come criterio di corrispondenza per selezionare una banda. Se nessuna banda corrisponde a uno dei criteri di selezione, STATUS_INVALID_PARAMETER viene restituito nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY.

Se BandID e BandStart sono entrambi impostati su -1, la richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY modificherà le proprietà della banda globale.

NewAuthKeyOffset e BandSecurityInfoOffset sono facoltativi a seconda dei requisiti dell'operazione. Se viene modificata solo la chiave di autenticazione, NewAuthKeyOffset viene impostato sul percorso della struttura di AUTH_KEY per la nuova chiave e BandSecurityInfoOffset è impostato su zero. Analogamente, se vengono modificate solo le proprietà di sicurezza, BandSecurityInfoOffset viene impostato sul percorso di BAND_SECURITY_INFO e NewAuthKeyOffset è impostato su 0.

I membri CryptoAlgoIdType e CryptoAlgoOidString della struttura BAND_SECURITY_INFO in BandSecurityInfoOffset non vengono usati in una richiesta di creazione della banda e devono essere impostati su 0.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 8
Intestazione	ehstorbandmgmt.h (include EhStorBandMgmt.h)

Vedi anche

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION