IVMVirtualPC::CreateVirtualMachine-Methode

  • Artikel

[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