Metodo IVdsAdvancedDisk::Clean (vds.h)

Articolo
03/08/2023

[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
S_OK	I dati sono stati rimossi correttamente e il disco non è stato inizializzato.
VDS_E_NO_MEDIA 0x80042412L	Non sono presenti supporti nel dispositivo rimovibile.
VDS_E_MISSING_DISK 0x80042454L	Disco mancante.
VDS_E_OPERATION_DENIED 0x8004240AL	L'operazione non è riuscita in una delle condizioni seguenti: Il disco contiene una partizione OEM e bForceOEM è false. Il disco contiene un volume o una partizione ESP e bForce è FALSE. Il disco contiene uno dei volumi di sistema indipendentemente dal fatto che bForce sia TRUE o FALSE. Un volume di sistema può essere uno degli elementi seguenti: Volume contenente il caricatore del sistema operativo. Volume di avvio che contiene la directory system32. Volume contenente il file di paging o il file di ibernazione o un volume utilizzato come dump di arresto anomalo del sistema. Partizione ESP (la partizione da cui viene avviato il sistema).
VDS_S_DISK_PARTIALLY_CLEANED 0x0004241AL	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

Vedi anche

Oggetto Disk

IVdsAdvancedDisk

IVdsAsync

Condividi tramite