Interface IVMNetworkAdapter

[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.

Propriétés

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

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

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

Spécifications