IVMVirtualMachine::Startup2-Methode

[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