Interface IVMNetworkAdapter
[Windows Computador Virtual não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]
Serve como a interface para uma NIC (placa de interface de rede virtual). Ele é usado para configurar como uma máquina virtual é rede. Os cartões de interface de rede podem ser adicionados e removidos usando IVMVirtualMachine::AddNetworkAdapter e IVMVirtualMachine::RemoveNetworkAdapter. Você também pode recuperar um objeto IVMNetworkAdapter da coleção IVMNetworkAdapterCollection retornada das propriedades IVMVirtualMachine::NetworkAdapters ou IVMVirtualNetwork::NetworkAdapters .
Membros
A interface IVMNetworkAdapter herda da interface IDispatch . IVMNetworkAdapter também tem esses tipos de membros:
Métodos
A interface IVMNetworkAdapter tem esses métodos.
| Método | Descrição |
|---|---|
| _ID | Recupera o identificador interno dessa interface de rede. |
| AttachToVirtualNetwork | Anexa o adaptador de rede à rede virtual especificada. |
| DetachFromVirtualNetwork | Desanexa a interface de rede de sua rede virtual. |
Propriedades
A interface IVMNetworkAdapter tem essas propriedades.
| Propriedade | Tipo de acesso | Descrição |
|---|---|---|
|
EthernetAddress |
Leitura/gravação |
O endereço Ethernet (MAC) da interface de rede. |
|
IsEthernetAddressDynamic |
Leitura/gravação |
Indica se o endereço Ethernet é gerado dinamicamente. |
|
VirtualMachine |
Somente leitura |
A máquina virtual associada a essa interface de rede. |
|
VirtualNetwork |
Somente leitura |
A rede virtual à qual o adaptador de rede está anexado. |
Comentários
O endereço Ethernet padrão para um adaptador de rede é "00-00-00-00-00-00", que é considerado um endereço Ethernet inválido pela maioria dos sistemas operacionais. Se IsEthernetAddressDynamic estiver definido como FALSE, ethernetAddress deverá ser inicializado com um endereço de rede Ethernet válido.
Os procedimentos a seguir explicam como usar a interface IVMNetworkAdapter .
Para anexar uma NIC virtual a uma NIC de host
- AS NICs virtuais (convidadas) não são anexadas diretamente a uma NIC de host. Em vez disso, a NIC virtual é anexada a uma rede virtual anexada a uma NIC de host. Para obter mais informações sobre como configurar redes virtuais, consulte IVMVirtualNetwork. Para anexar a NIC virtual a uma rede virtual, use o método AttachToVirtualNetwork .
Para desconectar uma NIC virtual da rede virtual
- O método DetachFromVirtualNetwork desanexará a NIC virtual da rede virtual. Depois que essa função for chamada, a propriedade VirtualNetwork retornará uma ID de rede virtual que não é válida.
Para remover uma NIC virtual de uma máquina virtual se você tiver o objeto NIC virtual
- Obtenha a máquina virtual associada à NIC virtual usando a propriedade VirtualMachine .
- Use o objeto atual como um parâmetro para o método IVMVirtualMachine::RemoveNetworkAdapter .
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 7 [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Nenhum compatível |
| Fim do suporte ao cliente |
Windows 7 |
| Produto |
Windows Virtual PC |
| Cabeçalho |
|
| IID |
IID_IVMNetworkAdapter é definido como e32e4165-22b8-4dc0-8d57-850171ae207a |