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
S _ OK
0
Der Vorgang wurde durchgeführt.
S _ FALSE
1
Das angegebene virtuelle Netzwerk wurde nicht gefunden.
E _ POINTER
0x80004003
Der parameter virtualNetwork ist NULL, oder das virtuelle Netzwerk wurde nicht gefunden.
E _ INVALIDARG
0x80000003
Der parameter virtualNetworkName ist ungültig oder eine leere Zeichenfolge.
HRESULT _ FROM _ WIN32(ERROR _ FILE NOT _ _ FOUND)
0x80070002
Die Datei des virtuellen Netzwerks wurde nicht gefunden.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.
VM _ E _ _ HARDWAREVIRTUALISIERUNG _ DEAKTIVIERT
0xA0040951
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
VPCCOMInterfaces.h
IID
IID _ IVMVirtualPC ist als 236ba0d9-a24a-4292-a132-27c1421dfd01 definiert.

Siehe auch

IVMVirtualPC