IVdsAdvancedDisk::Clean-Methode (vds.h)
[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts von der Windows Storage Management-API abgelöst.]
Entfernt Partitionsinformationen und hebt grundlegende oder dynamische Datenträger auf.
Windows Server 2003: Die Clean-Methode wird für Wechselmedien nicht unterstützt.
Syntax
HRESULT Clean(
[in] BOOL bForce,
[in] BOOL bForceOEM,
[in] BOOL bFullClean,
[out] IVdsAsync **ppAsync
);
Parameter
[in] bForce
Bei TRUE bereinigt ein Datenträger, der Datenvolumes oder ESP-Partitionen enthält.
[in] bForceOEM
Wenn TRUE, bereinigt einen MBR-basierten Datenträger, der die bekannten OEM-Partitionen in der folgenden Tabelle enthält, oder bereinigt einen GPT-basierten Datenträger, der eine BELIEBIGE OEM-Partition enthält. Für eine OEM-Partition ist das flag GPT_ATTRIBUTE_PLATFORM_REQUIRED auf einem GPT-basierten Datenträger festgelegt.
| Partitionstyp | BESCHREIBUNG |
|---|---|
| 0x12 | Eine EISA-Partition. |
| 0x84 | Eine Ruhezustandspartition für Laptops. |
| 0xA0 | Eine Diagnosepartition für einige HP-Laptops. |
| 0xDE | Eine von Dell definierte Partition. |
| 0xFE | Eine IBM IML-Partition. |
[in] bFullClean
Bei TRUE bereinigt der gesamte Datenträger, indem die Daten für jeden Sektor durch Nullen ersetzt werden. Andernfalls bereinigt diese Methode nur den ersten und den letzten Megabyte auf dem Datenträger.
[out] ppAsync
Die Adresse eines Zeigers auf den IVdsAsync-Schnittstellenzeiger , der von VDS bei der Rückgabe initialisiert wird. Aufrufer müssen die Schnittstelle freigeben. Verwenden Sie diesen Zeiger, um den Status des Vorgangs abzubrechen, darauf zu warten oder den Status des Vorgangs abzufragen.
Rückgabewert
Diese Methode kann HRESULT-Standardwerte wie E_INVALIDARG oder E_OUTOFMEMORY und VDS-spezifische Rückgabewerte zurückgeben. Es kann auch konvertierte Systemfehlercodes mithilfe des makros HRESULT_FROM_WIN32 zurückgeben. Fehler können vom VDS selbst oder vom zugrunde liegenden VDS-Anbieter stammen, der verwendet wird. Folgende Rückgabewerte sind möglich.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Daten wurden erfolgreich entfernt, und der Datenträger wurde nicht initialisiert. |
|
Das Wechselmedium enthält keine Medien. |
|
Der Datenträger fehlt. |
|
Der Vorgang ist unter einer der folgenden Bedingungen fehlgeschlagen:
|
|
Die Partitionstabelle wird bereinigt, aber nicht alle Sektoren werden während einer vollständigen Bereinigung bereinigt. Alternativ werden einige Sektoren des ersten Megabytes und des letzten Megabytes bereinigt; Die übrigen Sektoren werden jedoch nicht bereinigt, sofern es sich nicht um eine vollständige Reinigung handelt. |
Hinweise
Vor dem Aufrufen dieser Methode sollte der Aufrufer die Bereitstellung aller bereitgestellten Volumes auf dem Datenträger aufheben, indem er IVdsVolumeMF::D ismount für jedes Volume aufruft.
Verwenden Sie den bForce-Parameter , den bForceOEM-Parameter oder beides mit dieser Methode, es sei denn, Sie löschen zuerst alle Datenvolumes, 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.
Windows Server 2003: Die Clean-Methode wird für Wechselmedien nicht unterstützt.
Implementierer müssen einen Zeiger auf die IVdsAsync-Schnittstelle für diese Methode zurückgeben, unabhängig davon, ob der Aufruf einen asynchronen Vorgang initiiert.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | vds.h |
| Bibliothek | Uuid.lib |