IVMVirtualPC::FindVirtualNetwork-Methode

  • Artikel

[Windows Virtual PC ist ab Windows 8 nicht mehr 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 findenden 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 konnte nicht gefunden werden.
E_POINTER
0x80004003
 Der virtualNetwork-Parameter ist NULL , oder das virtuelle Netzwerk wurde nicht gefunden.
E_INVALIDARG
0x80000003
 Der virtualNetworkName-Parameter ist ungültig oder eine leere Zeichenfolge.
HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND)
0x80070002
 Die Datei des virtuellen Netzwerks konnte nicht gefunden werden.
DISP_E_EXCEPTION
0x80020009
 Ein unerwarteter Fehler ist aufgetreten.
VM_E_HARDWARE_VIRTUALIZATION_DISABLED
0xA0040951
 Hardwarebeschleunigte Virtualisierungserweiterungen (HAV) werden vom Prozessor nicht unterstützt.

Bemerkungen

Bei Namen virtueller Netzwerke wird die Groß-/Kleinschreibung nicht beachtet. Beispielsweise verweisen "MyNetwork" und "mynetwork" auf dasselbe virtuelle Netzwerk.

Anforderungen

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

Siehe auch

IVMVirtualPC