Compartilhar via


Propriedade IVMVirtualNetwork::HostAdapter

[O Pc Virtual do Windows não está mais disponível para uso a partir de Windows 8. Em vez disso, use o provedor WMI do Hyper-V (V2).]

Recupera o nome do adaptador ao qual a rede virtual está conectada.

Esta propriedade é somente para leitura.

Syntax

HRESULT get_HostAdapter(
  [out, retval] BSTR *hostAdapter
);

Valor da propriedade

O nome do adaptador de host ao qual a rede virtual está conectada.

Códigos de erro

Nome/valor Significado
S_OK
0
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro é NULL.
VM_E_ADAPTER_NOT_FOUND
0xA0040700
O adaptador Ethernet do host ao qual essa rede virtual estava conectada não está mais disponível. O adaptador Ethernet do host pode ter sido removido ou desabilitado.
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

Comentários

O adaptador de rede virtual permite que uma rede virtual se comunique com redes externas. Normalmente, há um adaptador por adaptador Ethernet instalado no computador host. Por exemplo, digamos que um computador host tenha um adaptador rotulado como "ENET 10/100". Para conectar uma NIC virtual à rede anexada a "10/100 ENET", defina a propriedade HostAdapter de Rede da rede virtual como "10/100 ENET" e conecte a NIC virtual a essa rede virtual.

Se a propriedade HostAdapter estiver definida como uma cadeia de caracteres vazia (""), o adaptador NIC virtual será conectado à rede "Rede Interna" ou "NAT (Rede Compartilhada)". As NICs virtuais anexadas à rede "Rede Interna" não terão acesso a redes externas no host do sistema. No entanto, as NICs virtuais anexadas a essa rede virtual ainda são capazes de se comunicar entre si.

A lista completa de adaptadores pode ser acessada por meio da propriedade IVMHostInfo::NetworkAdapters .

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
VPCCOMInterfaces.h
IID
IID_IVMVirtualNetwork é definido como 431cb7a1-2469-4563-b94e-38b987adca63

Confira também

IVMVirtualNetwork