Metodo IVdsAdvancedDisk::Clean (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.]
Rimuove le informazioni sulla partizione e annulla l'inizializzazione dei dischi di base o dinamici.
Windows Server 2003: Il metodo Clean non è supportato per i dispositivi rimovibili.
Sintassi
HRESULT Clean(
[in] BOOL bForce,
[in] BOOL bForceOEM,
[in] BOOL bFullClean,
[out] IVdsAsync **ppAsync
);
Parametri
[in] bForce
Se TRUE, pulisce un disco contenente volumi di dati o partizioni ESP.
[in] bForceOEM
Se TRUE, pulisce un disco basato su MBR contenente le partizioni OEM note nella tabella seguente o pulisce un disco basato su GPT contenente qualsiasi partizione OEM. Una partizione OEM ha il flag GPT_ATTRIBUTE_PLATFORM_REQUIRED impostato su un disco basato su GPT.
| Tipo di partizione | Descrizione |
|---|---|
| 0x12 | Partizione EISA. |
| 0x84 | Partizione di ibernazione per i portatili. |
| 0xa0 | Partizione di diagnostica per alcuni portatili HP. |
| 0xDE | Partizione definita da Dell. |
| 0xFE | Partizione IBM IML. |
[in] bFullClean
Se TRUE, pulisce l'intero disco sostituendo i dati in ogni settore con zeri; in caso contrario, questo metodo pulisce solo il primo e l'ultimo megabyte sul disco.
[out] ppAsync
Indirizzo di un puntatore al puntatore all'interfaccia IVdsAsync , che VDS inizializza al momento della restituzione. I chiamanti devono rilasciare l'interfaccia. Usare questo puntatore per annullare, attendere o eseguire una query sullo stato dell'operazione.
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 provenire dal VDS stesso o dal provider VDS sottostante in uso. I valori restituiti possibili includono quanto segue.
| Codice/valore restituito | Descrizione |
|---|---|
|
I dati sono stati rimossi correttamente e il disco non è stato inizializzato. |
|
Non sono presenti supporti nel dispositivo rimovibile. |
|
Disco mancante. |
|
L'operazione non è riuscita in una delle condizioni seguenti:
|
|
La tabella di partizione viene pulita, ma non tutti i settori vengono puliti durante una pulizia completa. In alternativa, alcuni settori del primo megabyte e dell'ultimo megabyte sono puliti; tuttavia, a meno che la pulizia non sia completamente pulita, i settori rimanenti non vengono puliti. |
Commenti
Prima di chiamare questo metodo, il chiamante deve smontare tutti i volumi montati sul disco chiamando IVdsVolumeMF::D ismount per ogni volume.
Usare il parametro bForce , il parametro bForceOEM o entrambi con questo metodo, a meno che non si eliminino prima tutti i volumi di dati, le partizioni OEM note e le partizioni ESP sul disco. Questo requisito esclude le partizioni di metadati, ad esempio MSR, la partizione dei metadati LDM e le partizioni OEM sconosciute.
Windows Server 2003: Il metodo Clean non è supportato per i dispositivi rimovibili.
Gli implementatori devono restituire un puntatore all'interfaccia IVdsAsync per questo metodo, indipendentemente dal fatto che la chiamata avvii un'operazione asincrona.
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 |