Ivmvirtualpc:: findvirtualmachine-Methode
[Windows Virtual PC ist nicht mehr für die Verwendung ab Windows 8 verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (v2).]
Ruft ein Objekt für virtuelle Maschinen ab, das mit der angeforderten Konfiguration übereinstimmt.
Syntax
HRESULT FindVirtualMachine(
[in] BSTR configurationName,
[out, retval] IVMVirtualMachine **virtualMachine
);
Parameter
-
ConfigurationName [ in]
-
Der Name des virtuellen Computers, der gefunden werden soll.
-
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. |
|
Die angegebene Konfiguration wurde nicht gefunden. |
|
Der ConfigurationName -Parameter ist ungültig, oder virtualmachine ist null. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der Prozessor bietet keine Unterstützung für hav-Erweiterungen (Hardware Beschleunigung Virtualization). |
Bemerkungen
Bei den Namen der virtuellen Computer wird die Groß-/Kleinschreibung nicht beachtet, z. b. "MyVM" und "MyVM" beziehen sich auf denselben virtuellen Computer.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Nur 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. |