IVdsAdvancedDisk::Clean-Methode (vds.h)

  • Artikel

[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
S_OK
 Die Daten wurden erfolgreich entfernt, und der Datenträger wurde nicht initialisiert.
VDS_E_NO_MEDIA
0x80042412L
 Das Wechselmedium enthält keine Medien.
VDS_E_MISSING_DISK
0x80042454L
 Der Datenträger fehlt.
VDS_E_OPERATION_DENIED
0x8004240AL
 Der Vorgang ist unter einer der folgenden Bedingungen fehlgeschlagen:
  • Der Datenträger enthält eine OEM-Partition, und bForceOEM ist false.
  • Der Datenträger enthält ein Volume oder eine ESP-Partition, und bForce ist FALSE.
  • Der Datenträger enthält eines der Systemvolumes, unabhängig davon, ob bForceTRUE oder FALSE ist. Ein Systemvolume kann eine der folgenden Elemente sein:
    • Ein Volume, das das Betriebssystemladeprogramm enthält.
    • Ein Startvolume, das das System32-Verzeichnis enthält.
    • Ein Volume, das die Auslagerungsdatei oder Ruhezustandsdatei enthält, oder ein Volume, das als Absturzabbild verwendet wird.
    • Eine ESP-Partition (die Partition, von der das System gestartet wird).
VDS_S_DISK_PARTIALLY_CLEANED
0x0004241AL
 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

Weitere Informationen

Disk-Objekt

IVdsAdvancedDisk

IVdsAsync