IVMNetworkAdapter-Schnittstelle

  • Artikel

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

Dient als Schnittstelle zu einer virtuellen Netzwerkschnittstelle Karte (NIC). Es wird verwendet, um festzulegen, wie ein virtueller Computer vernetzt ist. Netzwerkschnittstellenkarten können mithilfe von IVMVirtualMachine::AddNetworkAdapter und IVMVirtualMachine::RemoveNetworkAdapter hinzugefügt und entfernt werden. Sie können auch ein IVMNetworkAdapter-Objekt aus der IVMNetworkAdapterCollection-Auflistung abrufen, die von den Eigenschaften IVMVirtualMachine::NetworkAdapters oder IVMVirtualNetwork::NetworkAdapters zurückgegeben wird.

Member

Die IVMNetworkAdapter-Schnittstelle erbt von der IDispatch-Schnittstelle . IVMNetworkAdapter verfügt auch über die folgenden Arten von Membern:

Methoden

Die IVMNetworkAdapter-Schnittstelle verfügt über diese Methoden.

Methode BESCHREIBUNG
_ID Ruft den internen Bezeichner dieser Netzwerkschnittstelle ab.
AttachToVirtualNetwork Fügt die Netzwerkschnittstelle an das angegebene virtuelle Netzwerk an.
DetachFromVirtualNetwork Trennt die Netzwerkschnittstelle von ihrem virtuellen Netzwerk.

Eigenschaften

Die IVMNetworkAdapter-Schnittstelle verfügt über diese Eigenschaften.

Eigenschaft Zugriffstyp BESCHREIBUNG
EthernetAddress
 Lesen/Schreiben
 Die Ethernet-Adresse (MAC) der Netzwerkschnittstelle.
IsEthernetAddressDynamic
 Lesen/Schreiben
 Gibt an, ob die Ethernet-Adresse dynamisch generiert wird.
VirtualMachine
 Schreibgeschützt
 Der dieser Netzwerkschnittstelle zugeordnete virtuelle Computer.
VirtualNetwork
 Schreibgeschützt
 Das virtuelle Netzwerk, an das die Netzwerkschnittstelle angefügt ist.

Bemerkungen

Die Standardmäßige Ethernet-Adresse für eine Netzwerkschnittstelle lautet "00-00-00-00-00-00", was von den meisten Betriebssystemen als ungültige Ethernet-Adresse betrachtet wird. Wenn IsEthernetAddressDynamic auf FALSE festgelegt ist, muss EthernetAddress mit einer gültigen Ethernet-Netzwerkadresse initialisiert werden.

In den folgenden Verfahren wird erläutert, wie Die IVMNetworkAdapter-Schnittstelle verwendet wird.

So fügen Sie eine virtuelle NIC an eine Host-NIC an

  • Virtuelle (Gast-)NICs werden nicht direkt an eine Host-NIC angefügt. Stattdessen wird die virtuelle NIC an ein virtuelles Netzwerk angefügt, das an eine Host-NIC angefügt ist. Weitere Informationen zum Konfigurieren virtueller Netzwerke finden Sie unter IVMVirtualNetwork. Verwenden Sie die AttachToVirtualNetwork-Methode , um die virtuelle NIC an ein virtuelles Netzwerk anzufügen.

So trennen Sie eine virtuelle NIC vom virtuellen Netzwerk

So entfernen Sie eine virtuelle NIC von einem virtuellen Computer, wenn Sie über das virtuelle NIC-Objekt verfügen

  1. Rufen Sie den virtuellen Computer ab, der der virtuellen NIC zugeordnet ist, indem Sie die VirtualMachine-Eigenschaft verwenden.
  2. Verwenden Sie das aktuelle Objekt als Parameter für die IVMVirtualMachine::RemoveNetworkAdapter-Methode .

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_IVMNetworkAdapter ist definiert als e32e4165-22b8-4dc0-8d57-850171ae207a