ERASE_BAND_PARAMETERS-Struktur (ehstorbandmgmt.h)

Artikel
02/26/2024

Die ERASE_BAND_PARAMETERS-Struktur enthält die Auswahlkriterien für ein zu löschende Band. Darüber hinaus kann ein neuer Authentifizierungsschlüssel festgelegt werden. Diese Struktur ist eine Eingabe für eine IOCTL_EHSTOR_BANDMGMT_ERASE_BAND-Anforderung .

Syntax

typedef struct _ERASE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;

Member

StructSize

Die Größe dieser Struktur in Bytes. Auf sizeof(ERASE_BAND_PARAMETERS) festgelegt.

Flags

Vorgangsflags löschen. Dieser Wert ist eine bitweise OR-Kombination der folgenden.

Wert	Bedeutung
ERASEBAND_AUTHKEY_CACHING_ENABLED	Der neue Authentifizierungsschlüssel für dieses Band wird zwischengespeichert, sodass spätere Vorgänge automatisiert werden können.

Reserved

Reserviert.

BandId

Der Bezeichner eines einzelnen Bandes, für das Informationen zurückgegeben werden sollen. BandSize muss 0 sein, wenn ein einzelnes Band mit BandId ausgewählt wird. Wenn Sie BandStart und BandSize anstelle von BandId verwenden möchten, um ein Band auszuwählen, legen Sie BandId = (ULONG) –1 fest.

BandStart

Der Anfangsbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, eine Band an oder nach BandStart zuzuordnen.

NewAuthKeyOffset

Der Offset in Bytes einer AUTH_KEY-Struktur , die den neuen Autorisierungsschlüssel für das Band enthält. Der Offset befindet sich am Anfang des ERASE_BAND_PARAMETERS. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.

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

KeySize

Die Größe des Schlüssels in Byte der Schlüsseldaten unter Schlüssel. Wenn KeySize auf 0 festgelegt ist, wird ein Standardschlüssel verwendet.

Schlüssel

Ein Bytearray mit variabler Länge, das die Schlüsseldaten enthält.

Um einen Standardauthentifizierungsschlüssel für das Band anzugeben, legen Sie NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEY fest.

Hinweise

Die Rangfolge wird BandID für die Bandauswahl zugewiesen. Wenn BandID größer als 0 und BandID kleiner als das MaxBandCount-Element von BAND_MANAGEMENT_CAPABILITIES ist, wird BandID als einziges Auswahlkriterium für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, wird BandStart als Übereinstimmungskriterien verwendet, um ein Band auszuwählen. Wenn kein Band mit beiden Auswahlkriterien übereinstimmt, wird STATUS_INVALID_PARAMETER im IoStatus-Block für IOCTL_EHSTOR_BANDMGMT_ERASE_BAND zurückgegeben.