PROPRIÉTÉ IVMVirtualNetwork::HostAdapter

  • Article

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

Récupère le nom de l’adaptateur auquel le réseau virtuel est connecté.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_HostAdapter(
  [out, retval] BSTR *hostAdapter
);

Valeur de la propriété

Nom de la carte hôte à laquelle le réseau virtuel est connecté.

Codes d’erreur

Nom/valeur Signification
S_OK
0
 L'opération a réussi.
E_POINTER
0x80004003
 Le paramètre est NULL.
VM_E_ADAPTER_NOT_FOUND
0xA0040700
 L’adaptateur Ethernet hôte auquel ce réseau virtuel a été connecté n’est plus disponible. L’adaptateur Ethernet hôte a peut-être été supprimé ou désactivé.
DISP_E_EXCEPTION
0x80020009
 Une erreur inattendue s’est produite.

Notes

La carte réseau virtuelle permet à un réseau virtuel de communiquer avec des réseaux externes. Il y a normalement un adaptateur par carte Ethernet installé sur l’ordinateur hôte. Par exemple, supposons qu’un ordinateur hôte avait un adaptateur intitulé « 10/100 ENET ». Pour connecter une carte réseau virtuelle au réseau attaché à « 10/100 ENET », définissez la propriété Network HostAdapter du réseau virtuel sur « 10/100 ENET » et connectez la carte réseau virtuelle à ce réseau virtuel.

Si la propriété HostAdapter est définie sur une chaîne vide ( » « ), la carte réseau virtuelle est connectée au réseau « Réseau interne » ou « Réseau partagé (NAT) ». Les cartes réseau virtuelles attachées au réseau « Réseau interne » n’auront pas accès aux réseaux externes sur l’hôte système. Toutefois, les cartes réseau virtuelles attachées à ce réseau virtuel sont toujours en mesure de communiquer entre elles.

La liste complète des adaptateurs est accessible via la propriété IVMHostInfo::NetworkAdapters .

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_IVMVirtualNetwork est défini comme 431cb7a1-2469-4563-b94e-38b987adca63

Voir aussi

IVMVirtualNetwork