SET_BAND_SECURITY_PARAMETERS Struktur (ehstorbandmgmt.h)

Die Parameter zum Festlegen von Sicherheitseigenschaften für ein Band auf einem Speichergerät für eine IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY Anforderung werden in einer SET_BAND_SECURITY_PARAMETERS Struktur angegeben.

Syntax

typedef struct _SET_BAND_SECURITY_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         CurrentAuthKeyOffset;
  ULONG         NewAuthKeyOffset;
  ULONG         BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;

Angehörige

StructSize

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

Flags

Flags für Sicherheitsparameter. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.

Wert	Bedeutung
SETBANDSEC_AUTHKEY_CACHING_ENABLED	Der neue Authentifizierungsschlüssel kann zwischengespeichert werden, um einige Bandvorgänge zu automatisieren.

Reserved

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. Um BandStart- und BandSize anstelle BandId- zum Auswählen eines Bandes zu verwenden, 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.

CurrentAuthKeyOffset

Der Offset in Byte einer AUTH_KEY Struktur, die den aktuellen Authentifizierungsschlüssel für das Band enthält. Dieser Authentifizierungsschlüssel ist erforderlich und muss nach dieser Struktur vorhanden sein. Der Offset liegt vom Anfang SET_BAND_SECURITY_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.

NewAuthKeyOffset

Der Offset in Byte einer AUTH_KEY Struktur, die den neuen Authentifizierungsschlüssel für das Band enthält. Der Offset liegt vom Anfang SET_BAND_SECURITY_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 Standardauthentifizierungsschlüssel zuzuweisen, legen Sie AuthKeyOffset- = EHSTOR_BANDMGR_NO_KEYfest. Wenn NewAuthKeyOffset == CurrentAuthKeyOffset, bleibt der Authentifizierungsschlüssel für das Band unverändert.

BandSecurityInfoOffset

Der Offset in Byte einer BAND_SECURITY_INFO Struktur. Der Offset liegt vom Anfang SET_BAND_SECURITY_PARAMETERS.

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_SET_BAND_SECURITYzurückgegeben.

Wenn BandID und BandStart- auf –1 festgelegt sind, ändert die IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY Anforderung die Eigenschaften des globalen Bandes.

NewAuthKeyOffset und BandSecurityInfoOffset sind je nach den Anforderungen des Vorgangs optional. Wenn nur der Authentifizierungsschlüssel geändert wird, wird NewAuthKeyOffset- auf den Speicherort der AUTH_KEY Struktur für den neuen Schlüssel festgelegt, und BandSecurityInfoOffset- auf Null festgelegt ist. Wenn nur Sicherheitseigenschaften geändert werden, wird "BandSecurityInfoOffset"- auf den Speicherort BAND_SECURITY_INFO und "NewAuthKeyOffset"- auf 0 festgelegt.

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.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Verfügbar ab Windows 8
Header-	ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h)

Siehe auch

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION