IVMNetworkAdapter::EthernetAddress (Eigenschaft)

[Windows Der virtuelle PC ist ab diesem Zeitraum nicht mehr Windows 8. Verwenden Sie stattdessen den Hyper-V-WMI-Anbieter (V2).]

Ruft die Ethernet-Adresse (MAC) der Netzwerkschnittstelle ab und legt sie fest.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

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

Eigenschaftswert

Die MAC-Adresse der virtuellen NIC. Sie sollte das Format "XX - XX - XX - XX - XX - XX" haben, wobei jedes X eine Hexadezimalziffer ist.

Fehlercodes

Name/Wert Bedeutung
S _ OK
Der Vorgang wurde durchgeführt.
E _ ZEIGER 0X80004003
Der Parameter ist NULL.
E _ INVALIDARG-0x80000003
Der -Parameter hat nicht das richtige Format.
VM _ E _ CANT _ SET DYNAMIC MAC ADDRESS _ _ _ 0XA004070A
Die Ethernet-Adresse für eine Netzwerkschnittstelle kann entweder dynamisch generiert oder vom Benutzer auf eine statische Adresse festgelegt werden. Diese Methode kann nicht aufgerufen werden, wenn die Adresse so festgelegt ist, dass sie dynamisch generiert wird. Die IsEthernetAddressDynamic-Eigenschaft wird verwendet, um das Generierungsverhalten der Ethernet-Adresse zu ändern.
VM _ E _ VM _ UNKNOWN
0xA0040207
Der virtuelle Computer wurde nicht gefunden. Dies kann auftreten, wenn der Computer entfernt wurde, nachdem das IVMNetworkAdapter-Objekt erstellt wurde.
DISP _ E _ EXCEPTION
0x80020009
Ein unerwarteter Fehler ist aufgetreten.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 7 [ Desktop-Apps]
Unterstützte Mindestversion (Server)
Nicht unterstützt
Ende des Supports (Client)
Windows 7
Product (Produkt)
Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
IID _ IVMNetworkAdapter ist als e32e4165-22b8-4dc0-8d57-850171ae207a definiert.

Weitere Informationen

IVMNetworkAdapter