IVMNetworkAdapter：：EthernetAddress 屬性

  • 發行項

[Windows 虛擬電腦已不再可供Windows 8使用。 請改用 Hyper-V WMI 提供者 (V2) 。]

擷取並設定網路介面的乙太網路 (MAC) 位址。

這是可讀寫的屬性。

Syntax

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

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

屬性值

虛擬 NIC 的 MAC 位址。 其格式應該是 「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
標頭
HTTPCOMInterfaces.h
IID
 IID_IVMNetworkAdapter定義為 e32e4165-22b8-4dc0-8d57-850171ae207a

另請參閱

IVMNetworkAdapter