Metodo IVdsLun::D elete (vds.h)
[A partire da Windows 8 e Windows Server 2012, l'interfaccia COM del servizio disco virtuale viene sostituita dall'API gestione archiviazione di Windows.]
Elimina il LUN e tutti i relativi plessi. Tutti i dati nel LUN vengono persi. VDS libera gli extent allocati al LUN.
Sintassi
HRESULT Delete();
Valore restituito
Questo metodo può restituire valori HRESULT standard, ad esempio E_OUTOFMEMORY e valori restituiti specifici di VDS. Può anche restituire codici di errore di sistema convertiti usando la macro HRESULT_FROM_WIN32 . Gli errori possono provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
Questo valore restituito segnala un problema di comunicazione o software all'interno di un provider che memorizza nella cache le informazioni sulla matrice. Usare il metodo IVdsHwProvider::Reenumerate seguito dal metodo IVdsHwProvider::Refresh per ripristinare la cache. |
|
L'oggetto LUN non è più presente. |
|
Il LUN si trova in uno stato di errore e non è in grado di eseguire l'operazione richiesta. |
|
Un'altra operazione è in corso; questa operazione non può continuare fino al completamento dell'operazione o delle operazioni precedenti. |
Commenti
Se un'applicazione contiene un riferimento all'interfaccia IVdsLun e chiama IVdsLun::D elete, gli implementatori devono restituire VDS_E_OBJECT_DELETED nelle chiamate successive a metodi come GetProperties su tale interfaccia. In questo caso, l'interfaccia ha un riferimento in sospeso ed è valida, ma l'oggetto sottostante non esiste più.
Se viene eliminato un LUN non mascherato in un computer di destinazione, la visibilità del LUN su tale computer potrebbe non cambiare fino a quando non viene eseguita una nuova analisi del bus. L'applicazione VDS nel computer di destinazione avvia la nuova analisi del bus chiamando IVdsService::Reenumerate. L'avvio della ripetizione dell'analisi del bus è responsabilità dell'applicazione VDS, non del provider hardware.
Se un metodo come IVdsLun::D elete viene chiamato in un thread mentre IVdsSubSystem::QueryLuns viene chiamato in un altro thread in esecuzione contemporaneamente, il risultato potrebbe essere una violazione di accesso del provider. Il provider hardware è responsabile della serializzazione di questi metodi in base alle esigenze per ridurre al minimo tali problemi di sincronizzazione.
Il provider hardware è responsabile della rimozione delle informazioni sulla partizione del LUN in modo che il LUN possa essere riutilizzato. Se il LUN è un disco MBR, questa operazione viene eseguita scrivendo zeri nel primo e negli ultimi 1 MB del disco. Per un disco GPT, gli zeri devono essere scritti nel primo e negli ultimi 16 KB del disco.
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | vds.h |
| Libreria | Uuid.lib |