Partilhar via


Propriedade IVMNetworkAdapter::EthernetAddress

[O Computador 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 e define o endereço Ethernet (MAC) do adaptador de rede.

Essa propriedade é leitura/gravação.

Syntax

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

HRESULT get_EthernetAddress(
  [out, retval] BSTR *ethernetAddress
);

Valor da propriedade

O endereço MAC da NIC virtual. Ele deve ter o formato "XX-XX XX-XX-XX-XX XX-XX" em que cada X é um dígito hexadecimal.

Códigos de erro

Nome/valor Significado
S_OK
A operação foi bem-sucedida.
E_POINTER
0x80004003
O parâmetro é NULL.
E_INVALIDARG
0x80000003
O parâmetro não está no formato correto.
VM_E_CANT_SET_DYNAMIC_MAC_ADDRESS
0xA004070A
O endereço Ethernet para um adaptador de rede pode ser gerado dinamicamente ou pode ser definido como um endereço estático pelo usuário. Esse método não pode ser chamado quando o endereço é definido para ser gerado dinamicamente. A propriedade IsEthernetAddressDynamic é usada para alterar o comportamento de geração do endereço Ethernet.
VM_E_VM_UNKNOWN
0xA0040207
A máquina virtual não foi encontrada. Isso poderá ocorrer se o computador tiver sido removido após a criação do objeto IVMNetworkAdapter .
DISP_E_EXCEPTION
0x80020009
Ocorreu um erro inesperado.

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_IVMNetworkAdapter é definido como e32e4165-22b8-4dc0-8d57-850171ae207a

Confira também

IVMNetworkAdapter