Edit

Share via

IVMNetworkAdapter::IsEthernetAddressDynamic property

  • Article

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

Determines whether the Ethernet address is dynamically generated.

This property is read/write.

Syntax

HRESULT put_IsEthernetAddressDynamic(
  [in]          VARIANT_BOOL isDynamic
);

HRESULT get_IsEthernetAddressDynamic(
  [out, retval] VARIANT_BOOL *isDynamic
);

Property value

Set to VARIANT_TRUE if the Ethernet address should be dynamically generated and VARIANT_FALSE if the Ethernet address is static.

Error codes

Name/value Meaning
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The parameter is NULL.
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.

Remarks

This property should be set to TRUE (default) for most virtual network interfaces. If software in the guest requires a static Ethernet address, this property should be set to FALSE.

Requirements

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

See also

IVMNetworkAdapter