Interface IVMNetworkAdapter

Article
06/13/2023

[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Sert d’interface à une carte d’interface réseau virtuelle (NIC). Il est utilisé pour configurer la façon dont une machine virtuelle est mise en réseau. Les cartes d’interface réseau peuvent être ajoutées et supprimées à l’aide d’IVMVirtualMachine::AddNetworkAdapter et IVMVirtualMachine::RemoveNetworkAdapter. Vous pouvez également récupérer un objet IVMNetworkAdapter à partir de la collection IVMNetworkAdapterCollection retournée à partir des propriétés IVMVirtualMachine::NetworkAdapters ou IVMVirtualNetwork::NetworkAdapters .

Membres

L’interface IVMNetworkAdapter hérite de l’interface IDispatch. IVMNetworkAdapter possède également les types de membres suivants :

Méthodes
Propriétés

Méthodes

L’interface IVMNetworkAdapter contient ces méthodes.

Méthode	Description
_ID	Récupère l’identificateur interne de cette interface réseau.
AttachToVirtualNetwork	Attache l’interface réseau au réseau virtuel spécifié.
DetachFromVirtualNetwork	Détache l’interface réseau de son réseau virtuel.

Propriétés

L’interface IVMNetworkAdapter possède ces propriétés.

Propriété	Type d’accès	Description
EthernetAddress	Lecture/écriture	Adresse Ethernet (MAC) de l’interface réseau.
IsEthernetAddressDynamic	Lecture/écriture	Indique si l’adresse Ethernet est générée dynamiquement.
VirtualMachine	Lecture seule	Machine virtuelle associée à cette interface réseau.
VirtualNetwork	Lecture seule	Réseau virtuel auquel l’interface réseau est attachée.

Notes

L’adresse Ethernet par défaut pour une interface réseau est « 00-00-00-00-00-00 », qui est considérée comme une adresse Ethernet non valide par la plupart des systèmes d’exploitation. Si IsEthernetAddressDynamic a la valeur FALSE, EthernetAddress doit être initialisé avec une adresse réseau Ethernet valide.

Les procédures suivantes expliquent comment utiliser l’interface IVMNetworkAdapter .

Pour attacher une carte réseau virtuelle à une carte réseau hôte

Les cartes réseau virtuelles (invitées) ne sont pas attachées directement à une carte réseau hôte. Au lieu de cela, la carte réseau virtuelle est attachée à un réseau virtuel attaché à une carte réseau hôte. Pour plus d’informations sur la configuration des réseaux virtuels, consultez IVMVirtualNetwork. Pour attacher la carte réseau virtuelle à un réseau virtuel, utilisez la méthode AttachToVirtualNetwork .

Pour déconnecter une carte réseau virtuelle du réseau virtuel

La méthode DetachFromVirtualNetwork détache la carte réseau virtuelle du réseau virtuel. Une fois cette fonction appelée, la propriété VirtualNetwork retourne un ID de réseau virtuel non valide.

Pour supprimer une carte réseau virtuelle d’une machine virtuelle si vous avez l’objet de carte réseau virtuelle

Obtenez la machine virtuelle associée à la carte réseau virtuelle à l’aide de la propriété VirtualMachine .
Utilisez l’objet actuel comme paramètre de la méthode IVMVirtualMachine::RemoveNetworkAdapter .

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Aucun pris en charge
Fin de la prise en charge des clients	Windows 7
Produit	Windows Virtual PC
En-tête	VPCCOMInterfaces.h
IID	IID_IVMNetworkAdapter est défini comme e32e4165-22b8-4dc0-8d57-850171ae207a