Metodo IVdsVolume::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 volume e tutti i plessi, rilasciando gli extent.
Sintassi
HRESULT Delete(
[in] BOOL bForce
);
Parametri
[in] bForce
Se TRUE, VDS elimina il volume anche se è in uso; in caso contrario, il volume non viene eliminato se è in uso.
Valore restituito
Questo metodo può restituire valori HRESULT standard, ad esempio E_INVALIDARG o 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 derivare da VDS stesso o dal provider VDS sottostante usato. I valori restituiti possibili includono quanto segue.
| Codice restituito | Descrizione |
|---|---|
|
I plexes sono stati eliminati correttamente. |
Commenti
È possibile eliminare solo i volumi da un pacchetto online. Usare il metodo IVdsPack::GetProperties per verificare che lo stato del pacchetto sia VDS_PS_ONLINE.
Non è possibile eliminare un volume su supporti rimovibili.
VDS smonta il file system prima di eliminare un volume, un'operazione richiesta da FAT e FAT32, ma non NTFS. Inoltre, VDS elimina tutti i percorsi di accesso al volume dopo l'eliminazione del volume stesso. Se l'operazione di smontaggio ha esito negativo e bForce è true, VDS elimina il volume senza smontare. Le applicazioni client del file system devono gestire questa situazione. Se la smontazione ha esito positivo e l'operazione di eliminazione ha esito negativo, VDS tenta di rimontare il volume.
VDS impedisce l'eliminazione dei volumi di sistema e di avvio correnti, nonché del file di pagina, dell'arresto anomalo e dell'ibernazione dei volumi. È possibile spostare o reimpostare l'arresto anomalo e il file di pagina. Il volume di ibernazione deve rimanere nella partizione di avvio.
Windows Server 2003: I volumi di arresto anomalo e di ibernazione devono rimanere nella partizione di avvio.
Windows Server 2003: Dopo l'eliminazione del volume, il VDS tenta di eliminare le cartelle montate. In caso contrario, Elimina restituirà VDS_S_ACCESS_PATH_NOT_DELETED, anche se il volume è stato eliminato correttamente.
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 |