IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

Metadaten, die einem Band zugeordnet sind, werden mit einer IOCTL_EHSTOR_BANDMGMT_GET_BAND_METADATA Anforderung abgerufen. Die Metadaten für ein Band dienen als Datenbereich für eine Schlüssel-Manager-Anwendung.

Hauptcode

IRP_MJ_DEVICE_CONTROL

Eingabepuffer

Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer muss eine GET_BAND_METADATA_PARAMETERS Struktur enthalten.

Eingabepufferlänge

Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes an, die mindestens Größe der (GET_BAND_METADATA_PARAMETERS) sein muss.

Ausgabepuffer

Der Ausgabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält ein Bytearray von Bandmetadaten, die durch GET_BAND_METADATA_PARAMETERSangegeben werden.

Länge des Ausgabepuffers

Die Länge einer GET_BAND_METADATA_PARAMETERS Struktur.

Statusblock

Das Feld Information enthält die Anzahl der im Ausgabepuffer zurückgegebenen Bytes. Einer der folgenden Werte kann im Feld Status zurückgegeben werden.

Statuswert	Beschreibung
STATUS_SUCCESS	Die Metadaten wurden im Systempuffer zurückgegeben.
STATUS_INVALID_DEVICE_REQUEST	Das Speichergerät unterstützt keine Bandverwaltung.
STATUS_INVALID_BUFFER_SIZE	Die Ausgabepuffergröße ist falsch.
STATUS_INVALID_PARAMETER	Die Informationen im Eingabepuffer sind ungültig.
STATUS_NOT_FOUND	Das Band wurde für die angegebenen Auswahlkriterien nicht gefunden.
STATUS_IO_DEVICE_ERROR	Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel.

Bemerkungen

Die Authentifizierung für diese IOCTL ist nicht erforderlich, und ein Authentifizierungsschlüssel ist nicht als Eingabe enthalten.

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_SECURITY_INFO

CREATE_BAND_PARAMETERS