IVMHardDisk::Compact-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Komprimiert ein dynamisch expandierendes virtuelles Festplattenimage.

Syntax

HRESULT Compact(
  [out, retval] IVMTask **compactTask
);

Parameter

compactTask [out, retval]

Ein IVMTask-Objekt , das verwendet wird, um den Abschluss des Verdichtungsprozesses nachzuverfolgen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert BESCHREIBUNG
S_OK
0
 Der Vorgang wurde durchgeführt.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.
E_POINTER
0x80004003
 Der Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_SHARING_VIOLATION)
0x80070020
 Das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, wird verwendet.
HRESULT_FROM_WIN32(ERROR_DISK_FULL)
0x80070070
 Das Hostvolume verfügt nicht über genügend Speicherplatz, um eine temporäre Datei zu erstellen, die für die Komprimierung dieses virtuellen Festplattenimages erforderlich ist.
VM_E_APP_SHUTTING_DOWN
0xA0040209
 Das virtuelle Festplattenimage kann nicht komprimiert werden, da die Anwendung heruntergefahren wird.
VM_E_FILE_READ_ONLY
0xA004067A
 Das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, ist als schreibgeschützt gekennzeichnet.
VM_E_WRONG_HD_IMAGE_TYPE
0xA004067B
 Das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, muss ein vmDiskTypeDynamic-Imagetyp sein.
VM_E_INVALID_HD_FILE
0xA0040682
 Das virtuelle Festplattenimage, auf das von diesem IVMHardDisk-Objekt verwiesen wird, scheint kein gültiges Image zu sein.

Bemerkungen

Um ein dynamisch expandierendes Festplattenimage zu komprimieren, sollte der freie Speicherplatz auf dem Datenträgerimage zuerst auf Null gesetzt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Nicht unterstützt
Ende des Supports (Client)
 Windows 7
Produkt
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMHardDisk ist definiert als ffa14ae6-48f5-42a4-8a22-186f2e5c7db0

Siehe auch

IVMHardDisk