IVMVirtualMachine::Startup2-Methode

Artikel
06/13/2023

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

Startet den virtuellen Computer (VM) aus dem nicht initialisierten oder gespeicherten Zustand mit erweiterten Optionen.

Diese Methode bietet einen Mechanismus zum Starten eines virtuellen Computers mit einem unterschiedlichen Datenträger, auch wenn der Zeitstempel des übergeordneten Datenträgers geändert wurde.

Syntax

HRESULT Startup2(
  [in]          VMStartupOption startupOption,
  [out, retval] IVMTask         **startupTask
);

Parameter

startupOption [in]: Die erweiterte Startoption. Die möglichen Werte stammen aus der VMStartupOption-Enumeration .
startupTask [out, retval]: Ein IVMTask-Objekt , das verwendet wird, um den Abschlussfortschritt der Startsequenz nachzuverfolgen.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_INVALIDARG 0x80000003	Der parameter startupOption ist ungültig.
E_POINTER 0x80004003	Der startupTask-Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Der Aufrufer muss über Ausführungszugriffsberechtigungen verfügen, um diese VM zu starten.
VM_E_TIMED_OUT 0xA0040202	Der Vorgang wurde nicht rechtzeitig abgeschlossen.
VM_E_OUT_OF_RESOURCE 0xA0040203	Es gibt nicht genügend Hostressourcen.
VM_E_TOO_MANY_VMS 0xA0040204	Es gibt zu viele aktive VMs.
VM_E_VM_RUNNING 0xA0040500	Der virtuelle Computer wird bereits ausgeführt.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Die folgenden Werte können über die Error-Eigenschaft des zurückgegebenen IVMTask-Objekts zurückgegeben werden.

Fehlercode/- wert	BESCHREIBUNG
`VM_E_UNSUPPORTED_HARDWARE` (0xA0040950)	Die Hardware unterstützt keine Virtualisierung.
`VM_E_HARDWARE_VIRTUALIZATION_DISABLED` (0xA0040951)	Die Hardwarevirtualisierung ist deaktiviert.
`VM_E_VMVIRTUALPC_OLDER_VERSION` (0xA0040952)	Sowohl Virtual PC 2007 als auch Windows Virtual PC sind installiert.
`VM_E_OTHER_VIRTUALIZATION_SOFTWARE` (0xA0040953)	Andere Virtualisierungssoftware ist installiert.
`VM_E_OUT_OF_RESOURCE` (0xa00400203)	Es gibt nicht genügend Hostressourcen.

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_IVMVirtualMachine ist definiert als f7092aa1-33ed-4f78-a59f-c00adfc2edd7

Siehe auch

IVMVirtualMachine

Freigeben über