IVMVirtualPC::CreateVirtualMachine-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).]

Erstellt eine neue VM-Konfiguration und ruft das Objekt des virtuellen Computers ab.

Syntax

HRESULT CreateVirtualMachine(
  [in]          BSTR              configurationName,
  [in]          BSTR              configurationPath,
  [out, retval] IVMVirtualMachine **virtualMachine
);

Parameter

configurationName [in]: Der Name des zu erstellenden virtuellen Computers. Die Länge des Namens darf 80 Zeichen nicht überschreiten, und die kombinierte Länge von Name und Pfad zu VMC- und VMCX-Dateien darf MAX_PATH (260) Zeichen nicht überschreiten. Die Dateinamenerweiterungen .vmc und .vmcx werden am Ende des Vm-Namens angefügt, wenn die Konfigurationsdateien erstellt werden. Wenn dieser Parameter NULL oder eine leere Zeichenfolge ist, muss der configurationPath-Parameter den vollständigen Pfad zur VMC-Datei angeben.
configurationPath [in]: Der Pfad zu dem Ordner, der die VMC-Datei enthält. Dieser Ordner wird erstellt, wenn er nicht vorhanden ist. Wenn configurationNameNULL oder eine leere Zeichenfolge ist, muss der vollständige Pfad der neuen Konfigurationsdatei angegeben werden.
virtualMachine [out, retval]: Ein Zeiger auf ein neues IVMVirtualMachine-Objekt , das diesen virtuellen Computer darstellt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode/-wert	BESCHREIBUNG
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der parameter configurationName oder configurationPath ist ungültig, oder der virtualMachine-Parameter ist NULL.
HRESULT_FROM_WIN32(ERROR_PATH_NOT_FOUND) 0x80070003	Der vom configurationPath-Parameter angegebene Pfad kann vom System nicht gefunden werden.
HRESULT_FROM_WIN32(ERROR_INVALID_NAME) 0x8007007b	Der parameter configurationPath enthält ein ungültiges Zeichen (eines von "*?:<>/\|").
HRESULT_FROM_WIN32(ERROR_BAD_PATHNAME) 0x800700a1	Der parameter configurationPath gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich.
HRESULT_FROM_WIN32(ERROR_BUFFER_OVERFLOW) 0x8007006f	Der durch die Parameter configurationName und configurationPath angegebene Pfad führt zu einem zu langen Pfad. Die Gesamtlänge des Pfads muss kleiner als MAX_PATH (260) Zeichen sein.
HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS) 0x800700b7	An diesem Speicherort ist bereits eine Konfigurationsdatei mit diesem Namen vorhanden.
VM_E_CONFIG_NO_NAME 0xA0040400	Der parameter configurationName ist leer.
VM_E_CONFIG_NAME_TOO_LONG 0xA0040401	Der Parameter configurationName überschreitet eine Länge von 80 Zeichen.
VM_E_CONFIG_NAME_INVALID_CHAR 0xA0040402	Der parameter configurationName enthält ein ungültiges Zeichen (eines von "*?:<>/\|\").
VM_E_CONFIG_DUPLICATE_NAME 0xA0040403	Es gibt bereits einen virtuellen Computer mit diesem Namen.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED 0xA0040951	Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Bei namen virtueller Computer wird die Groß-/Kleinschreibung nicht beachtet, z. B. beziehen sich "MyVM" und "myvm" auf denselben virtuellen Computer.

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

Siehe auch

IVMVirtualPC

Teilen über