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 zusammen mit den neuen Metadaten enthalten, die für das Band festgelegt werden sollen.
Wenn der AuthKeyOffset-Member von SET_BAND_METADATA_PARAMETERS auf EHSTOR_BANDMGR_NO_KEY festgelegt ist, müssen die Eingabedaten im Systempuffer keine AUTH_KEY-Struktur enthalten.
Länge des Eingabepuffers
Parameters.DeviceIoControl.InputBufferLength gibt die Größe des Puffers in Bytes an, die mindestens sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY) sein muss.
Ausgabepuffer
Keine.
Länge des Ausgabepuffers
Keine.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden:
| Statuswert | BESCHREIBUNG |
|---|---|
| STATUS_SUCCESS | Die Metadaten wurden für das ausgewählte 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 | Fehler bei der Kommunikation. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
Hinweise
Metadaten können auch mithilfe dieser 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 Löschmuster fest. Um sicherzustellen, dass vertrauliche Informationen in Metadatenblobs entfernt werden, sollte dieser Löschvorgang ausgeführt werden, bevor ein Band aus der Bandtabelle des Silotreibers gelöscht wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows 8 und höheren Versionen von Windows. |
| Kopfzeile | ehstorbandmgmt.h (include EhStorBandMgmt.h) |