CREATE_BAND_PARAMETERS Struktur (ehstorbandmgmt.h)

Artikel
02/06/2025

Die Parameter zum Erstellen eines Bandes auf einem Speichergerät für eine IOCTL_EHSTOR_BANDMGMT_CREATE_BAND Anforderung werden in einer CREATE_BAND_PARAMETERS Struktur angegeben.

Syntax

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

Angehörige

StructSize

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

Flags

Kennzeichnungen für die Banderstellung. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.

Wert	Bedeutung
CREATEBAND_AUTHKEY_CACHING_ENABLED	Der Authentifizierungsschlüssel für dieses Band wird zwischengespeichert, wodurch die Automatisierung späterer Vorgänge ermöglicht wird. Der Authentifizierungsschlüssel wird zwischengespeichert, wenn dieses Kennzeichen festgelegt ist und das Band nicht sowohl für das Lesen als auch für das Schreiben gesperrt ist.

BandLocationInfoOffset

Der Offset in Byte einer BAND_LOCATION_INFO Struktur. Der Offset liegt vom Anfang CREATE_BAND_PARAMETERS.

BandSecurityInfoOffset

Der Offset in Byte einer BAND_SECURITY_INFO Struktur. Der Offset liegt vom Anfang CREATE_BAND_PARAMETERS. Wenn dieser Wert 0 ist, d. h. keine Bandsicherheitsinformationen vorhanden sind, werden Schlüssel-Manager-Metadaten für das Band auf alle Nullen festgelegt. Wenn dieses Mitglied 0 ist, werden die Lese- und Schreibsperrzustände standardmäßig auf PERSISTANT_UNLOCK festgelegt.

AuthKeyOffset

Der Offset in Byte einer AUTH_KEY Struktur, die den Autorisierungsschlüssel für das neue Band enthält. Der Offset liegt vom Anfang CREATE_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 dem Band einen Standardautorisierungsschlüssel zuzuweisen, legen Sie AuthKeyOffset = EHSTOR_BANDMGR_NO_KEYfest.

Bemerkungen

Die CryptoAlgoIdType und CryptoAlgoOidString Mitglieder der BAND_SECURITY_INFO Struktur bei BandSecurityInfoOffset werden nicht in einer Banderstellungsanforderung verwendet und müssen auf 0 festgelegt werden.