IVMVirtualPC::GetHardDisk-Methode

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

Ruft ein Objekt ab, das einer vorhandenen Datenträgerimagedatei entspricht.

Syntax

HRESULT GetHardDisk(
  [in]          BSTR        imagePath,
  [out, retval] IVMHardDisk **hardDisk
);

imagePath [in]: Der vollständige Pfad zu einer vorhandenen Datenträgerimagedatei.
HardDisk [out, retval]: Ein IVMHardDisk-Objekt , das diesem Datenträgerimage entspricht.

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der imagePath - oder hardDisk-Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) 0x80070002	Das System kann die durch den imagePath-Parameter angegebene Datei nicht finden.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Das System kann den durch den imagePath-Parameter angegebenen Pfad nicht finden.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Der imagePath-Parameter enthält ein ungültiges Zeichen (eines von "*?:<>/\|"").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Der imagePath-Parameter gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Der durch den imagePath-Parameter angegebene Pfad ist zu lang. Die Länge des Pfads muss kleiner als 260 Zeichen sein.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).

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_IVMVirtualPC ist definiert als 236ba0d9-a24a-4292-a132-27c1421dfd01