Partager via


PROPRIÉTÉ IVMNetworkAdapter::EthernetAddress

[Windows Virtual PC n’est plus disponible à partir de Windows 8. Utilisez plutôt le fournisseur WMI Hyper-V (V2).]

Récupère et définit l’adresse Ethernet (MAC) de l’interface réseau.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT put_EthernetAddress(
  [in]          BSTR ethernetAddress
);

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

Valeur de la propriété

Adresse MAC de la carte réseau virtuelle. Il doit avoir la forme « XX-XX-XX--XX-XX » où chaque X est un chiffre hexadécimal.

Codes d’erreur

Nom/valeur Signification
S_OK
L'opération a réussi.
E_POINTER
0x80004003
Le paramètre est NULL.
E_INVALIDARG
0x80000003
Le paramètre n’est pas au format correct.
VM_E_CANT_SET_DYNAMIC_MAC_ADDRESS
0xA004070A
L’adresse Ethernet d’une interface réseau peut être générée dynamiquement ou définie sur une adresse statique par l’utilisateur. Cette méthode ne peut pas être appelée lorsque l’adresse est définie pour être générée dynamiquement. La propriété IsEthernetAddressDynamic est utilisée pour modifier le comportement de génération de l’adresse Ethernet.
VM_E_VM_UNKNOWN
0xA0040207
La machine virtuelle est introuvable. Cela peut se produire si la machine a été supprimée après la création de l’objet IVMNetworkAdapter .
DISP_E_EXCEPTION
0x80020009
Une erreur inattendue s’est produite.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge
Aucun pris en charge
Fin de la prise en charge des clients
Windows 7
Produit
Windows Virtual PC
En-tête
VPCCOMInterfaces.h
IID
IID_IVMNetworkAdapter est défini comme e32e4165-22b8-4dc0-8d57-850171ae207a

Voir aussi

IVMNetworkAdapter