DELETE_BAND_PARAMETERS struttura (ehstorbandmgmt.h)

Articolo
08/07/2023

Una banda configurata viene eliminata in base ai parametri in una struttura DELETE_BAND_PARAMETERS . Questa struttura è input per una richiesta di IOCTL_EHSTOR_BANDMGMT_DELETE_BAND .

Sintassi

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

Members

StructSize

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

Flags

Eliminare i flag di operazione. Questo valore è una combinazione OR bit per bit del seguente.

Valore	Significato
DELBAND_ERASE_BEFORE_DELETE	Eseguire una cancellazione crittografica dei dati delle proprietà band prima dell'eliminazione.

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.

AuthKeyOffset

Offset, in byte, di una struttura AUTH_KEY contenente la chiave di autorizzazione per la banda. L'offset si trova dall'inizio di DELETE_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 contenente i dati delle chiavi.

Per specificare una chiave di autenticazione predefinita sulla banda, impostare AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY. Se flag contiene DELBAND_ERASE_BEFORE_DELETE, è necessario impostare AuthKeyOffset su 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 ai criteri di selezione, STATUS_INVALID_PARAMETER viene restituito nel blocco IoStatus per IOCTL_EHSTOR_BANDMGMT_DELETE_BAND.

Se DELBAND_ERASE_BEFORE_DELETE è impostato in Flag, non è necessaria una chiave di autenticazione per eliminare la band. Se questo flag non è impostato, la chiave di autenticazione corrente deve essere inclusa in AuthKeyOffset.