Condividi tramite

IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL (ehstorbandmgmt.h)

  • Articolo

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

IRP_MJ_DEVICE_CONTROL

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)

Vedi anche

SET_BAND_METADATA_PARAMETERS