ERASE_BAND_PARAMETERS Struktur (ehstorbandmgmt.h)
Die ERASE_BAND_PARAMETERS Struktur enthält die Auswahlkriterien für einen zu löschenden Bereich. Darüber hinaus kann ein neuer Authentifizierungsschlüssel festgelegt werden. Diese Struktur wird für eine IOCTL_EHSTOR_BANDMGMT_ERASE_BAND Anforderung eingegeben.
Syntax
typedef struct _ERASE_BAND_PARAMETERS {
ULONG StructSize;
ULONG Flags;
ULONG Reserved;
ULONG BandId;
LARGE_INTEGER BandStart;
ULONG NewAuthKeyOffset;
} ERASE_BAND_PARAMETERS, *PERASE_BAND_PARAMETERS;
Angehörige
StructSize
Die Größe dieser Struktur in Byte. Wird auf Größe(ERASE_BAND_PARAMETERS) festgelegt.
Flags
Löschvorgangskennzeichnungen. Dieser Wert ist eine bitweise OR-Kombination aus dem folgenden.
Wert | Bedeutung |
---|---|
|
Der neue Authentifizierungsschlüssel für dieses Band wird zwischengespeichert, sodass spätere Vorgänge automatisiert werden können. |
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. 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.
NewAuthKeyOffset
Der Offset in Byte einer AUTH_KEY Struktur, die den neuen Autorisierungsschlüssel für das Band enthält. Der Offset liegt vom Anfang ERASE_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 NewAuthKeyOffset = EHSTOR_BANDMGR_NO_KEYfest.
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_ERASE_BANDzurückgegeben.
.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Verfügbar ab Windows 8 |
Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |