IVdsVolume::D elete-Methode (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API ersetzt.]

Löscht das Volume und alle Plexes, und gibt die Erweiterungen frei.

Syntax

HRESULT Delete(
  [in] BOOL bForce
);

Parameter

[in] bForce

Bei TRUE löscht VDS das Volume, auch wenn es verwendet wird. Andernfalls wird das Volume nicht gelöscht, wenn es verwendet wird.

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 HRESULT_FROM_WIN32-Makros 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 Beschreibung
S_OK
Die Plexes wurden erfolgreich gelöscht.

Hinweise

Sie können nur Volumes aus einem Onlinepaket löschen. Verwenden Sie die IVdsPack::GetProperties-Methode , um zu bestätigen, dass der Packstatus VDS_PS_ONLINE ist.

Sie können kein Volume löschen, das sich auf Wechselmedien befindet.

VDS hebt die Bereitstellung des Dateisystems auf, bevor ein Volume gelöscht wird– ein Vorgang, der für FAT und FAT32, aber nicht für NTFS erforderlich ist. Darüber hinaus löscht VDS alle Zugriffspfade auf das Volume, nachdem das Volume selbst gelöscht wurde. Wenn beim Demountvorgang ein Fehler auftritt und bForcetrue ist, löscht VDS das Volume ohne Demount. Dateisystemclientanwendungen müssen diese Situation verarbeiten. Wenn die Bereitstellung erfolgreich aufgehoben wurde und der Löschvorgang fehlschlägt, versucht VDS, das Volume erneut einzubinden.

VDS verhindert das Löschen der aktuellen System- und Startvolumes sowie der Seitendatei-, Absturzdump- und Ruhezustandsvolumes. Sie können den Absturzdump und die Seitendatei verschieben oder zurücksetzen. Das Ruhezustandsvolume muss auf der Startpartition verbleiben.

Windows Server 2003: Das Absturzdump- und Ruhezustandsvolume muss auf der Startpartition verbleiben.

Windows Server 2003: Nachdem das Volume gelöscht wurde, versucht VDS, die eingebundenen Ordner zu löschen. Wenn dies fehlschlägt, gibt DeleteVDS_S_ACCESS_PATH_NOT_DELETED zurück, obwohl das Volume erfolgreich gelöscht wurde.

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

IVdsPack::GetProperties

IVdsVolume

VDS_PACK_STATUS