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