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 corrispondenza di Irp->AssociatedIrp.SystemBuffer deve contenere una SET_BAND_METADATA_PARAMETERS ed eventualmente una struttura AUTH_KEY insieme ai nuovi metadati da impostare per la banda.
Se il AuthKeyOffset membro 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 di 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 | Le dimensioni del buffer di input non sono corrette. |
| 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. |
Osservazioni
I metadati possono anche essere cancellati 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 modello di cancellazione. Per garantire la rimozione di informazioni riservate nei BLOB di metadati, è necessario eseguire questa operazione di cancellazione prima di eliminare una banda dalla tabella band del driver silo.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows 8 e versioni successive di Windows. |
| intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |