IVMNetworkAdapter：：EthernetAddress 属性

  • 项目

[自Windows 8起，Windows 虚拟电脑不再可供使用。 请改用 Hyper-V WMI 提供程序 (V2) 。]

检索并设置网络接口的以太网 (MAC) 地址。

此属性是可读写的。

语法

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

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

属性值

虚拟 NIC 的 MAC 地址。 它应采用“XX-XX XX-XX--XX XX-”的形式，其中每个 X 是一个十六进制数字。

错误代码

名称/值 含义
S_OK
 操作成功。
E_POINTER
0x80004003
 参数为 NULL。
E_INVALIDARG
0x80000003
 参数的格式不正确。
VM_E_CANT_SET_DYNAMIC_MAC_ADDRESS
0xA004070A
 网络接口的以太网地址可以动态生成，也可以由用户设置为静态地址。 将地址设置为动态生成时，无法调用此方法。 IsEthernetAddressDynamic 属性用于更改以太网地址的生成行为。
VM_E_VM_UNKNOWN
0xA0040207
 找不到虚拟机。 如果在创建 IVMNetworkAdapter 对象后删除了计算机，则可能会发生这种情况。
DISP_E_EXCEPTION
0x80020009
 发生意外错误。

要求

要求 值
最低受支持的客户端
 Windows 7 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
客户端支持终止
 Windows 7
产品
 Windows Virtual PC
标头
VPCCOMInterfaces.h
IID
 IID_IVMNetworkAdapter定义为 e32e4165-22b8-4dc0-8d57-850171ae207a

另请参阅

IVMNetworkAdapter