IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)
I metadati associati a una banda vengono impostati con una richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA . I metadati per una banda fungono da area dati per un'applicazione di gestione delle chiavi.
Codice principale
Buffer di input
Il buffer di input in Irp-AssociatedIrp.SystemBuffer> deve contenere un SET_BAND_METADATA_PARAMETERS ed eventualmente una struttura AUTH_KEY insieme ai nuovi metadati da impostare per la banda.
Se il membro AuthKeyOffset di SET_BAND_METADATA_PARAMETERS è impostato su EHSTOR_BANDMGR_NO_KEY, i dati di input nel buffer di sistema non devono includere una struttura AUTH_KEY .
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof (SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY).
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
Uno dei valori seguenti può essere restituito nel campo Stato :
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | I metadati sono stati impostati per la banda selezionata. |
| STATUS_INVALID_DEVICE_REQUEST | Il dispositivo di archiviazione non supporta la gestione della banda. |
| STATUS_INVALID_BUFFER_SIZE | La dimensione del buffer di input non è corretta. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_NOT_FOUND | La banda non è stata trovata per i criteri di selezione specificati. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
Commenti
È anche possibile cancellare i metadati usando questo IOCTL. Per cancellare i metadati per una banda, impostare la parte dei metadati del buffer di input su tutti gli zeri o su un altro criterio di cancellazione. Per garantire la rimozione delle informazioni riservate nei BLOB di metadati, questa operazione di cancellazione deve essere eseguita prima di eliminare una banda dalla tabella band del driver silo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |