Metodo Clear della classe MSFT_Disk
Rimuove le informazioni sulla partizione e annulla l'inizializzazione di un disco, restituendolo a uno stato RAW.
Sintassi
UInt32 Clear(
[in] Boolean RemoveData,
[in] Boolean RemoveOEM,
[in] Boolean ZeroOutEntireDisk,
[out] String ExtendedStatus
);
Parametri
RemoveData [in]
TRUE se è corretto rimuovere le partizioni di dati dal disco. Se questo parametro è FALSE o NULL, questo metodo avrà esito negativo in presenza di una partizione dati.
RemoveOEM [in]
TRUE se è ok rimuovere OEM e altre partizioni speciali. Se questo parametro è FALSE o non specificato, questo metodo avrà esito negativo in presenza di questi tipi di partizioni.
ZeroOutEntireDisk [in]
TRUE se questo parametro indica a questo metodo di zero l'intero disco, oltre alla rimozione di tutte le informazioni sulla partizione. Se questo parametro è FALSE o NULL, vengono zero solo i primi e gli ultimi megabyte del disco.
ExtendedStatus [out]
Stringa che contiene un oggetto MSFT_StorageExtendedStatus incorporato.
Questo parametro consente al provider di archiviazione di restituire informazioni di errore estese (specifiche dell'implementazione).
Valore restituito
Successo (0)
Non supportato (1)
Errore non specificato (2)
Timeout (3)
Errore (4)
Parametro non valido (5)
Il disco è in uso (6)
Accesso negato (40001)
Non sono disponibili risorse sufficienti per completare l'operazione. (40002)
Cache non aggiornata (40003)
Il disco non è stato inizializzato. (41000)
Il disco è di sola lettura. (41002)
Il disco è offline. (41003)
Impossibile cancellare le partizioni OEM presenti. Per cancellare le partizioni OEM, usare il flag RemoveOEM. (41007)
Impossibile cancellare con le partizioni dati presenti. Per cancellare le partizioni di dati, usare il flag RemoveData. (41008)
Operazione non supportata in un disco critico. (41009)
Nel dispositivo non sono presenti supporti. (41015)
L'oggetto specificato viene gestito dal componente Clustering di failover Microsoft. Il disco deve essere rimosso dal cluster per eseguire questa operazione. (41019)
Commenti
Il chiamante deve specificare RemoveData, RemoveOEM o entrambi, a meno che non elimini prima tutte le partizioni 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 [solo app desktop] |
| Server minimo supportato | Windows Server 2012 [solo app desktop] |
| Spazio dei nomi | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |