DELETE_BAND_PARAMETERS-Struktur (ehstorbandmgmt.h)

Artikel
02/29/2024

Ein konfiguriertes Band wird gemäß den Parametern in einer DELETE_BAND_PARAMETERS-Struktur gelöscht. Diese Struktur ist eine Eingabe für eine IOCTL_EHSTOR_BANDMGMT_DELETE_BAND-Anforderung .

Syntax

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

Member

StructSize

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

Flags

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

Wert	Bedeutung
DELBAND_ERASE_BEFORE_DELETE	Führen Sie vor dem Löschen eine kryptografische Löschung der Bandeigenschaftendaten durch.

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.

AuthKeyOffset

Der Offset in Byte einer AUTH_KEY-Struktur , die den Autorisierungsschlüssel für das Band enthält. Der Offset befindet sich am Anfang der DELETE_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 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY fest. Wenn FlagsDELBAND_ERASE_BEFORE_DELETE enthält, muss AuthKeyOffset auf EHSTOR_BANDMGR_NO_KEY festgelegt werden.

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_DELETE_BAND zurückgegeben.

Wenn DELBAND_ERASE_BEFORE_DELETE in Flags festgelegt ist, ist kein Authentifizierungsschlüssel erforderlich, um das Band zu löschen. Wenn dieses Flag nicht festgelegt ist, muss der aktuelle Authentifizierungsschlüssel in AuthKeyOffset eingeschlossen werden.