IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY IOCTL (ehstorbandmgmt.h)
Le proprietà di sicurezza delle bande in un dispositivo di archiviazione gestito tramite banda vengono modificate con la richiesta di IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY .
Codice principale
Buffer di input
Il buffer in Irp-AssociatedIrp.SystemBuffer> deve contenere una struttura SET_BAND_SECURITY_PARAMETERS seguita dalle strutture AUTH_KEY e BAND_SECURITY_INFO.
Se il membro AuthKeyOffset di SET_BAND_SECURITY_PARAMETERS è impostato su EHSTOR_BANDMGR_NO_KEY, i dati di input nel buffer di sistema non devono includere una struttura AUTH_KEY . Inoltre, se non viene specificata una nuova chiave di autenticazione, non è inclusa alcuna struttura di chiave aggiornata.
Lunghezza del buffer di input
Parameters.DeviceIoControl.InputBufferLength indica le dimensioni, in byte, del buffer, che devono essere almeno sizeof (SET_BAND_SECURITY_PARAMETERS) + 2 * sizeof(AUTH_KEY) + sizeof(BAND_SECURITY_INFO) quando sono necessarie tutte le strutture di input.
Buffer di output
Nessuno.
Lunghezza del buffer di output
Nessuno.
Blocco dello stato
È possibile restituire uno dei valori seguenti nel campo Stato .
| Valore di stato | Descrizione |
|---|---|
| STATUS_SUCCESS | Le proprietà di sicurezza per la banda sono state modificate. |
| 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 è valida. |
| STATUS_INVALID_PARAMETER | Le informazioni nel buffer di input non sono valide. |
| STATUS_NOT_FOUND | Non è stata trovata una banda per i criteri di selezione specificati. |
| STATUS_ACCESS_DENIED | La chiave di autenticazione specificata non è valida. |
| STATUS_IO_DEVICE_ERROR | Comunicazione non riuscita. Il dispositivo di archiviazione potrebbe non essere compatibile con i protocolli di sicurezza. |
Commenti
Il blocco e lo sblocco di lettura e scrittura per le bande vengono impostati con questo IOCTL nella struttura BAND_SECURITY_INFO inclusa come input nel buffer di sistema.
Le modifiche della chiave di autenticazione non influiscono sullo stato di blocco della banda. Non è necessario smontare un volume per modificare una chiave di autenticazione con questa richiesta.
Quando una banda viene sbloccata, ovvero i membri Readlock o WriteLock di BAND_SECURITY_INFO sono FALSE, il driver silo memorizza nella cache la chiave di autenticazione fornita se SETBANDSEC_AUTHKEY_CACHING_ENABLED è impostato nel membro Flags di SET_BAND_SECURITY_PARAMETERS.
Come caso speciale, questo IOCTL può essere usato per notificare al driver silo che una banda è stata sbloccata senza l'uso dei membri di blocco in BAND_SECURITY_INFO. A tale scopo, il membro NewAuthKeyOffset di SET_BAND_SECURITY_PARAMETERS è impostato su CurrentAuthKeyOffset con BandSecurityInfoOffset impostato su 0. In questo caso, non si verificano modifiche alla sicurezza, ma la chiave fornita in CurrentAuthKeyOffset viene memorizzata nella cache in memoria, purché SETBANDSEC_AUTHKEY_CACHING_ENABLED sia impostata in Flag.
Le modifiche apportate alla tabella di banda da questa richiesta vengono sottoposte al commit atomico del dispositivo prima del completamento della richiesta IOCTL. Pertanto, è garantito che la banda venga modificata con tutte le relative proprietà impostate o nessuna proprietà impostata a tutti se si verifica un sistema o un guasto di alimentazione.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile a partire da Windows 8 |
| Intestazione | ehstorbandmgmt.h (include EhStorBandMgmt.h) |