DELETE_BAND_PARAMETERS Struktur (ehstorbandmgmt.h)

Artikel
02/06/2025

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

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;

Angehörige

StructSize

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

Flags

Löschvorgangskennzeichnungen. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.

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

Reserved

Reserviert.

BandId

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

BandStart

Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, ein Band an oder nach BandStart-abzugleichen.

AuthKeyOffset

Der Offset in Byte einer AUTH_KEY Struktur, die den Autorisierungsschlüssel für das Band enthält. Der Offset liegt vom Anfang 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 bei Key-. 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_KEYfest. Wenn FlagsDELBAND_ERASE_BEFORE_DELETEenthält, muss AuthKeyOffset- auf EHSTOR_BANDMGR_NO_KEYfestgelegt werden.

Bemerkungen

Rangfolge wird BandID- für die Bandauswahl zugewiesen. Wenn BandID- größer als 0 ist und BandID- kleiner als das MaxBandCount Mitglied von BAND_MANAGEMENT_CAPABILITIESist, wird BandID- als einzige Auswahlkriterien für eine Band-Übereinstimmung verwendet. Wenn BandID == –1, wird BandStart- als Übereinstimmungskriterien zum Auswählen eines Bandes verwendet. Wenn kein Band mit beiden Auswahlkriterien übereinstimmt, wird STATUS_INVALID_PARAMETER im IoStatus- Block für IOCTL_EHSTOR_BANDMGMT_DELETE_BANDzurückgegeben.

Wenn DELBAND_ERASE_BEFORE_DELETE in Flagsfestgelegt ist, ist kein Authentifizierungsschlüssel zum Löschen des Bandes erforderlich. Wenn dieses Flag nicht festgelegt ist, muss der aktuelle Authentifizierungsschlüssel bei AuthKeyOffset-enthalten sein.