Interfaz IVMNetworkAdapter

[Windows Virtual PC ya no está disponible para su uso a partir de Windows 8. En su lugar, use el proveedor WMI de Hyper-V (V2)].

Actúa como interfaz para una tarjeta de interfaz de red virtual (NIC). Se usa para configurar cómo se reda una máquina virtual. Las tarjetas de interfaz de red se pueden agregar y quitar mediante IVMVirtualMachine::AddNetworkAdapter y IVMVirtualMachine::RemoveNetworkAdapter. También puede recuperar un objeto IVMNetworkAdapter de la colección IVMNetworkAdapterCollection devuelta desde las propiedades IVMVirtualMachine::NetworkAdapters o IVMVirtualNetwork::NetworkAdapters .

Miembros

La interfaz IVMNetworkAdapter hereda de la interfaz IDispatch . IVMNetworkAdapter también tiene estos tipos de miembros:

• Métodos
• Propiedades

Métodos

La interfaz IVMNetworkAdapter tiene estos métodos.

Método	Descripción
_ID	Recupera el identificador interno de esta interfaz de red.
AttachToVirtualNetwork	Asocia la interfaz de red a la red virtual especificada.
DetachFromVirtualNetwork	Desasocia la interfaz de red de su red virtual.

Propiedades

La interfaz IVMNetworkAdapter tiene estas propiedades.

Propiedad	Tipo de acceso	Descripción
EthernetAddress	Lectura/escritura	Dirección Ethernet (MAC) de la interfaz de red.
IsEthernetAddressDynamic	Lectura/escritura	Indica si la dirección Ethernet se genera dinámicamente.
VirtualMachine	Solo lectura	Máquina virtual asociada a esta interfaz de red.
VirtualNetwork	Solo lectura	Red virtual a la que está conectada la interfaz de red.

Comentarios

La dirección Ethernet predeterminada para una interfaz de red es "00-00-00-00-00-00", que la mayoría de los sistemas operativos considera una dirección Ethernet no válida. Si IsEthernetAddressDynamic está establecido en FALSE, EthernetAddress debe inicializarse con una dirección de red Ethernet válida.

En los procedimientos siguientes se explica cómo usar la interfaz IVMNetworkAdapter .

Para conectar una NIC virtual a una NIC de host

• Las NIC virtuales (invitadas) no están conectadas directamente a una NIC de host. En su lugar, la NIC virtual está conectada a una red virtual que está conectada a una NIC de host. Para obtener más información sobre cómo configurar redes virtuales, consulte IVMVirtualNetwork. Para conectar la NIC virtual a una red virtual, use el método AttachToVirtualNetwork .

Para desconectar una NIC virtual de la red virtual

• El método DetachFromVirtualNetwork desasociará la NIC virtual de la red virtual. Después de llamar a esta función, la propiedad VirtualNetwork devolverá un identificador de red virtual que no es válido.

Para quitar una NIC virtual de una máquina virtual si tiene el objeto NIC virtual

1. Obtenga la máquina virtual asociada a la NIC virtual mediante la propiedad VirtualMachine .
2. Utilice el objeto actual como parámetro para el método IVMVirtualMachine::RemoveNetworkAdapter .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Fin de compatibilidad de cliente	Windows 7
Producto	Windows Virtual PC
Encabezado	VPCCOMInterfaces.h
IID	IID_IVMNetworkAdapter se define como e32e4165-22b8-4dc0-8d57-850171ae207a