Clear-Methode der MSFT_Disk-Klasse
Entfernt Partitionsinformationen, hebt die Initialisierung eines Datenträgers auf und versetzt ihn in einen RAW-Zustand zurück.
Syntax
UInt32 Clear(
[in] Boolean RemoveData,
[in] Boolean RemoveOEM,
[in] Boolean ZeroOutEntireDisk,
[out] String ExtendedStatus
);
Parameter
RemoveData [in]
TRUE , wenn es in Ordnung ist, Datenpartitionen vom Datenträger zu entfernen. Wenn dieser Parameter FALSE oder NULL ist, tritt bei dieser Methode ein Fehler auf, wenn eine Datenpartition vorhanden ist.
RemoveOEM [in]
TRUE , wenn es in Ordnung ist, OEM- und andere spezielle Partitionen zu entfernen. Wenn dieser Parameter FALSE ist oder nicht angegeben ist, tritt bei dieser Methode ein Fehler auf, wenn diese Partitionstypen vorhanden sind.
ZeroOutEntireDisk [in]
TRUE , wenn dieser Parameter diese Methode anweist, neben dem Entfernen aller Partitionsinformationen auch den gesamten Datenträger auf Null zu stellen. Wenn dieser Parameter FALSE oder NULL ist, werden nur die ersten und letzten Megabytes des Datenträgers auf null gesetzt.
ExtendedStatus [out]
Eine Zeichenfolge, die ein eingebettetes MSFT_StorageExtendedStatus -Objekt enthält.
Mit diesem Parameter kann der Speicheranbieter erweiterte (implementierungsspezifische) Fehlerinformationen zurückgeben.
Rückgabewert
Erfolg (0)
Nicht unterstützt (1)
Nicht angegebener Fehler (2)
Timeout (3)
Fehler (4)
Ungültiger Parameter (5)
Datenträger wird verwendet (6)
Zugriff verweigert (40001)
Es sind nicht genügend Ressourcen vorhanden, um den Vorgang abzuschließen. (40002)
Cache veraltet (40003)
Der Datenträger wurde nicht initialisiert. (41000)
Der Datenträger ist schreibgeschützt. (41002)
Der Datenträger ist offline. (41003)
Kann nicht gelöscht werden, wenn OEM-Partitionen vorhanden sind. Verwenden Sie zum Löschen von OEM-Partitionen das RemoveOEM-Flag. (41007)
Kann nicht gelöscht werden, wenn Datenpartitionen vorhanden sind. Verwenden Sie zum Löschen von Datenpartitionen das RemoveData-Flag. (41008)
Der Vorgang wird auf einem kritischen Datenträger nicht unterstützt. (41009)
Das Gerät enthält keine Medien. (41015)
Das angegebene Objekt wird von der Komponente Microsoft Failoverclustering verwaltet. Der Datenträger muss aus dem Cluster entfernt werden, um diesen Vorgang ausführen zu können. (41019)
Hinweise
Der Aufrufer muss RemoveData, RemoveOEM oder beides angeben, es sei denn, er löscht zuerst alle Datenpartitionen, bekannten OEM-Partitionen und ESP-Partitionen auf dem Datenträger. Diese Anforderung schließt Metadatenpartitionen wie die MSR, die LDM-Metadatenpartition und unbekannte OEM-Partitionen aus.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Namespace | Stamm\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |