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 |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Der Parameter configurationName oder configurationPath ist ungültig, oder der virtualMachine-Parameter ist NULL. |
|
Das System kann den durch den configurationPath-Parameter angegebenen Pfad nicht finden. |
|
Der parameter configurationPath enthält ein ungültiges Zeichen (eines von * "?:<>/""). | |
|
Der configurationPath-Parameter gibt einen leeren oder relativen Pfad an. Ein absoluter Pfad ist erforderlich. |
|
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. |
|
An diesem Speicherort ist bereits eine Konfigurationsdatei mit diesem Namen vorhanden. |
|
Der parameter configurationName ist leer. |
|
Der parameter configurationName überschreitet die Länge von 80 Zeichen. |
|
Der parameter configurationName enthält ein ungültiges Zeichen (eines von * "?:<>/""). | \ |
|
Es ist bereits ein virtueller Computer mit diesem Namen vorhanden. |
|
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization). |
|
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 |
|
| IID |
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert. |