IVMVirtualPC::FindVirtualNetwork-Methode
[Windows Der virtuelle PC ist ab Windows 8 nicht mehr für die Verwendung verfügbar. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]
Ruft ein virtuelles Netzwerkobjekt ab, das dem angeforderten Namen entspricht.
Syntax
HRESULT FindVirtualNetwork(
[in] BSTR virtualNetworkName,
[out, retval] IVMVirtualNetwork **virtualNetwork
);
Parameter
-
virtualNetworkName [ In]
-
Der Name des zu suchender virtuellen Netzwerks.
-
virtualNetwork [ out, retval]
-
Ein Zeiger auf ein neues IVMVirtualNetwork-Objekt, das dieses virtuelle Netzwerk darstellt.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Der Vorgang wurde durchgeführt. |
|
Das angegebene virtuelle Netzwerk wurde nicht gefunden. |
|
Der parameter virtualNetwork ist NULL, oder das virtuelle Netzwerk wurde nicht gefunden. |
|
Der parameter virtualNetworkName ist ungültig oder eine leere Zeichenfolge. |
|
Die Datei des virtuellen Netzwerks wurde nicht gefunden. |
|
Ein unerwarteter Fehler ist aufgetreten. |
|
Der Prozessor unterstützt keine HAV-Erweiterungen (Hardware Accelerated Virtualization). |
Bemerkungen
Bei Namen virtueller Netzwerke wird die Groß-/Kleinschreibung nicht beachtet, z. B. beziehen sich "MyNetwork" und "mynetwork" auf dasselbe virtuelle Netzwerk.
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. |