IVMNetworkAdapter::EthernetAddress property

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves and sets the Ethernet (MAC) address of the network interface.

This property is read/write.

Syntax

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

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

The MAC address of the virtual NIC. It should have the form "XX-XX-XX-XX-XX-XX" where each X is a hexadecimal digit.

Name/value	Meaning
S_OK	The operation was successful.
E_POINTER 0x80004003	The parameter is NULL.
E_INVALIDARG 0x80000003	The parameter is not in the correct format.
VM_E_CANT_SET_DYNAMIC_MAC_ADDRESS 0xA004070A	The Ethernet address for a network interface can either be generated dynamically or can be set to a static address by the user. This method cannot be called when the address is set to be generated dynamically. The IsEthernetAddressDynamic property is used to change the generation behavior of the Ethernet address.
VM_E_VM_UNKNOWN 0xA0040207	The virtual machine was not found. This may occur if the machine was removed after the IVMNetworkAdapter object was created.
DISP_E_EXCEPTION 0x80020009	An unexpected error has occurred.

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	None supported
End of client support	Windows 7
Product	Windows Virtual PC
Header	VPCCOMInterfaces.h
IID	IID_IVMNetworkAdapter is defined as e32e4165-22b8-4dc0-8d57-850171ae207a