SET_BAND_SECURITY_PARAMETERS Struktur (ehstorbandmgmt.h)
Die Parameter zum Festlegen der 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;
Member
StructSize
Die Größe dieser Struktur in Bytes. Legen Sie auf sizeof(SET_BAND_SECURITY_PARAMETERS) fest.
Flags
Sicherheitsparameterflags. Dieser Wert ist eine bitweise OR-Kombination der folgenden.
| Wert | Bedeutung |
|---|---|
|
Der neue Authentifizierungsschlüssel kann zwischengespeichert werden, um einige Bandvorgänge zu automatisieren. |
Reserved
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 ist. Wenn Sie BandStart und BandSize anstelle von BandId verwenden möchten, um ein Band auszuwählen, legen Sie BandId = (ULONG) –1 fest.
BandStart
Der Startbytespeicherort auf dem Speichergerät, um eine Bandsuche zu starten. Es wird versucht, eine Band bei oder nach BandStart zuzuordnen.
CurrentAuthKeyOffset
Der Offset 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 ist von 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 Bytes) 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_KEY fest.
NewAuthKeyOffset
Der Offset einer AUTH_KEY Struktur, die den neuen Authentifizierungsschlüssel für das Band enthält. Der Offset ist von 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 Bytes) 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_KEY fest. Wenn NewAuthKeyOffset == CurrentAuthKeyOffset ist, bleibt der Authentifizierungsschlüssel für das Band unverändert.
BandSecurityInfoOffset
Der Offset einer BAND_SECURITY_INFO Struktur in Bytes. Der Offset ist von Anfang SET_BAND_SECURITY_PARAMETERS.
Hinweise
Die BandID für die Bandauswahl hat Vorrang. Wenn BandID größer als 0 und BandID kleiner als das MaxBandCount-Mitglied 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 eine Band auszuwählen. Wenn kein Band mit beiden Auswahlkriterien übereinstimmt, wird STATUS_INVALID_PARAMETER im IoStatus-Block für IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY zurückgegeben.
Wenn BandID und BandStart beide 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 und BandSecurityInfoOffset auf 0 festgelegt. Wenn nur Sicherheitseigenschaften geändert werden, wird BandSecurityInfoOffset auf den Speicherort von BAND_SECURITY_INFO und NewAuthKeyOffset auf 0 festgelegt.
Die CryptoAlgoIdType - und CryptoAlgoOidString-Member der BAND_SECURITY_INFO-Struktur bei BandSecurityInfoOffset werden nicht in einer Banderstellungsanforderung verwendet und müssen auf 0 festgelegt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar ab Windows 8 |
| Kopfzeile | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |