IVdsAdvancedDisk::D eletePartition-Methode (vds.h)

  • Artikel

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

Löscht eine Partition von einem Basisdatenträger.

Syntax

HRESULT DeletePartition(
  [in] ULONGLONG ullOffset,
  [in] BOOL      bForce,
  [in] BOOL      bForceProtected
);

Parameter

[in] ullOffset

Der Partitionsoffset.

[in] bForce

Wenn dieser Parameter auf TRUE festgelegt ist, löscht VDS alle Partitionen bedingungslos (mit Ausnahme von OEM, ESP oder MSR). Wenn er auf FALSE festgelegt ist, schlägt der Vorgang fehl, wenn die Partition verwendet wird. Eine Partition wird als verwendet betrachtet, wenn Aufrufe zum Sperren oder Aufheben der Bereitstellung des Volumes fehlschlagen.

[in] bForceProtected

Wenn dieser Parameter auf TRUE festgelegt ist, löscht VDS alle geschützten Partitionen (einschließlich OEM, ESP und MSR) bedingungslos. Wenn er auf FALSE festgelegt ist, schlägt der Vorgang fehl, wenn die Partition geschützt ist.

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 Partition wurde erfolgreich gelöscht.
VDS_E_INVALID_OPERATION
0x80042415L
 Die Medien unterstützen diesen Vorgang nicht. Sie können beispielsweise keine Partition auf einer CD-ROM löschen.
VDS_E_NOT_SUPPORTED
0x80042400L
 Dieser Vorgang wird auf dynamischen Datenträgern nicht unterstützt.
VDS_E_PARTITION_NOT_EMPTY
0x80042408L
 Die erweiterte Partition ist nicht leer.
VDS_E_BAD_PROVIDER_DATA
0x80042441L
 Dieser Wert gibt einen Anbieterfehler an. Der Vorgang wird abgebrochen.
VDS_E_DEVICE_IN_USE
0x80042413L
 Die Partition wird verwendet.
VDS_S_ACCESS_PATH_NOT_DELETED
0x00044244L
 Die Partition wurde erfolgreich gelöscht, aber VDS konnte die Zugriffspfade nicht entfernen.
VDS_S_UPDATE_BOOTFILE_FAILED
0x00042434L
 Die Partition wurde erfolgreich gelöscht, aber VDS konnte die Startoptionen im BCD-Speicher (Boot Configuration Data) nicht aktualisieren.

Windows Server 2003: Startoptionen werden in der boot.ini-Datei auf einem x86- oder x64-System oder NVRAM auf einem Itanium-System gespeichert.

Anforderungen

Anforderung Wert
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