IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
Metadaten, die einem Band zugeordnet sind, werden mit einer IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA Anforderung festgelegt. Die Metadaten für ein Band dienen als Datenbereich für eine Schlüssel-Manager-Anwendung.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer muss eine SET_BAND_METADATA_PARAMETERS und möglicherweise eine AUTH_KEY Struktur sowie die neuen Metadaten enthalten, die für das Band festgelegt werden sollen.
Wenn das AuthKeyOffset- element von SET_BAND_METADATA_PARAMETERS auf EHSTOR_BANDMGR_NO_KEYfestgelegt ist, müssen die Eingabedaten im Systempuffer keine AUTH_KEY Struktur enthalten.
Eingabepufferlänge
Parameters.DeviceIoControl.InputBufferLength- gibt die Größe des Puffers in Bytes an, die mindestens Größe von (SET_BAND_METADATA_PARAMETERS) + MetadataSize + Sizeof(AUTH_KEY) sein muss.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden:
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Die Metadaten wurden für den ausgewählten Band festgelegt. |
| STATUS_INVALID_DEVICE_REQUEST | Das Speichergerät unterstützt keine Bandverwaltung. |
| STATUS_INVALID_BUFFER_SIZE | Die Größe des Eingabepuffers 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
Metadaten können auch mithilfe dieses IOCTL gelöscht werden. Um Metadaten für ein Band zu löschen, legen Sie den Metadatenteil des Eingabepuffers auf alle Nullen oder ein anderes Radiermuster fest. Um sicherzustellen, dass vertrauliche Informationen in Metadatenblobs entfernt werden, sollte dieser Löschvorgang vor dem Löschen eines Bandes aus der Bandtabelle des Silotreibers ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |