ERASE_BAND_PARAMETERS struttura (ehstorbandmgmt.h)
La struttura ERASE_BAND_PARAMETERS contiene i criteri di selezione per una banda da cancellare. È inoltre possibile impostare una nuova chiave di autenticazione. Questa struttura è input per una richiesta di IOCTL_EHSTOR_BANDMGMT_ERASE_BAND .
Sintassi
typedef struct _ERASE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;
Members
StructSize
La dimensione di questa struttura in byte. Impostare su sizeof(ERASE_BAND_PARAMETERS).
Flags
Eliminare i flag di operazione. Questo valore è una combinazione OR bit per bit del seguente.
| Valore | Significato |
|---|---|
|
La nuova chiave di autenticazione per questa banda viene memorizzata nella cache che consente l'automazione delle operazioni successive. |
Reserved
Riservato.
BandId
Identificatore di una singola banda per restituire informazioni. BandSize deve essere 0 quando viene selezionata una singola band con BandId. Per usare BandStart e BandSize anziché BandId per selezionare una band, impostare BandId = (ULONG) -1.
BandStart
Percorso di byte iniziale nel dispositivo di archiviazione per avviare una ricerca band. Viene eseguito un tentativo di corrispondere a una band in o dopo BandStart.
NewAuthKeyOffset
Offset, in byte, di una struttura AUTH_KEY contenente la nuova chiave di autorizzazione per la banda. L'offset si trova dall'inizio di ERASE_BAND_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 delle chiavi 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 specificare una chiave di autenticazione predefinita sulla banda, impostare NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY.
Commenti
La precedenza viene assegnata a BandID per la selezione di band. 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 band. Se BandID == -1, BandStart viene usato come criteri di corrispondenza per selezionare una band. Se nessuna banda corrisponde a uno dei criteri di selezione, STATUS_INVALID_PARAMETER viene restituito nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_ERASE_BAND.
.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8 |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |