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
S_OK	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

Vedi anche

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS