IVMVirtualNetwork::HostAdapter-Eigenschaft

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. Verwenden Sie stattdessen den Hyper-V WMI-Anbieter (V2).]

Ruft den Namen des Adapters ab, mit dem das virtuelle Netzwerk verbunden ist.

Diese Eigenschaft ist schreibgeschützt.

Syntax

HRESULT get_HostAdapter(
  [out, retval] BSTR *hostAdapter
);

Eigenschaftswert

Der Name des Hostadapters, mit dem das virtuelle Netzwerk verbunden ist.

Fehlercodes

Name/Wert	Bedeutung
S_OK 0	Der Vorgang wurde durchgeführt.
E_POINTER 0x80004003	Der Parameter ist NULL.
VM_E_ADAPTER_NOT_FOUND 0xA0040700	Der Host-Ethernet-Adapter, mit dem dieses virtuelle Netzwerk verbunden war, ist nicht mehr verfügbar. Der Host-Ethernet-Adapter wurde möglicherweise entfernt oder deaktiviert.
DISP_E_EXCEPTION 0x80020009	Ein unerwarteter Fehler ist aufgetreten.

Bemerkungen

Der adapter für virtuelle Netzwerke ermöglicht es einem virtuellen Netzwerk, mit externen Netzwerken zu kommunizieren. Normalerweise ist ein Adapter pro Ethernet-Adapter auf dem Hostcomputer installiert. Angenommen, ein Hostcomputer verfügte über einen Adapter mit der Bezeichnung "10/100 ENET". Um eine virtuelle Netzwerkkarte mit dem Netzwerk zu verbinden, das an "10/100 ENET" angefügt ist, legen Sie die Network HostAdapter-Eigenschaft des virtuellen Netzwerks auf "10/100 ENET" fest, und verbinden Sie die virtuelle Netzwerkkarte mit diesem virtuellen Netzwerk.

Wenn die HostAdapter-Eigenschaft auf eine leere Zeichenfolge ("") festgelegt ist, wird der virtuelle NIC-Adapter mit dem Netzwerk "Internal Network" oder "Shared Networking (NAT)" verbunden. Virtuelle NICs, die an das Netzwerk "Internes Netzwerk" angefügt sind, haben keinen Zugriff auf externe Netzwerke auf dem Systemhost. Die virtuellen Netzwerkkarten, die an dieses virtuelle Netzwerk angefügt sind, können jedoch weiterhin miteinander kommunizieren.

Auf die vollständige Liste der Adapter kann über die IVMHostInfo::NetworkAdapters-Eigenschaft zugegriffen werden.

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_IVMVirtualNetwork ist definiert als 431cb7a1-2469-4563-b94e-38b987adca63

Siehe auch

IVMVirtualNetwork