IVMVirtualPC::CreateVirtualMachine-Methode

[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Erstellt eine neue Konfiguration des virtuellen Computers 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) Nicht überschreiten. Die Dateierweiterungen .vmc und .vmcx werden beim Erstellen der Konfigurationsdateien an das Ende des Namens des virtuellen Computers angefügt. 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 enthalten soll. Dieser Ordner wird erstellt, wenn er nicht vorhanden ist. Wenn configurationName NULL 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 _ ZEIGER 0X80004003
Der Parameter configurationName oder configurationPath ist ungültig, oder der virtualMachine-Parameter ist NULL.
HRESULT _ FROM _ WIN32(ERROR _ PATH NOT _ _ FOUND)
0x80070003
Das System kann den durch den configurationPath-Parameter angegebenen Pfad nicht finden.
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 configurationPath-Parameter 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 die 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 ist bereits ein virtueller Computer mit diesem Namen vorhanden.
VM _ E _ _ HARDWAREVIRTUALISIERUNG _ DEAKTIVIERT
0XA0040951
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization).
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Hinweise

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

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [ 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 als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC