IVMNetworkAdapter::EthernetAddress-Eigenschaft

[Windows Virtual PC ist ab Windows 8 nicht mehr verfügbar. 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
);

Die MAC-Adresse der virtuellen NIC. Es sollte die Form "XX-XX XX-XX--XX XX-" haben, wobei jedes X eine hexadezimale Zahl ist.

Name/Wert	Bedeutung
S_OK	Der Vorgang wurde durchgeführt.
E_POINTER 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.

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