Skip to content

Latest commit

 

History

History
89 lines (56 loc) · 4.53 KB

ivmvirtualnetwork-hostadapter.md

File metadata and controls

89 lines (56 loc) · 4.53 KB
Raw
title description ms.assetid keywords topic_type api_name api_location api_type ms.topic ms.date
IVMVirtualNetwork HostAdapter property (VPCCOMInterfaces.h)
Name of the adapter to which the virtual network is connected.
7ee074d2-13ba-42db-84db-ecfd22576a9a
HostAdapter property Virtual PC
HostAdapter property Virtual PC , IVMVirtualNetwork interface
IVMVirtualNetwork interface Virtual PC , HostAdapter property
apiref
IVMVirtualNetwork.HostAdapter
IVMVirtualNetwork.get_HostAdapter
VPCCOMInterfaces.h
COM
reference
05/31/2018

IVMVirtualNetwork::HostAdapter property

[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]

Retrieves the name of the adapter to which the virtual network is connected.

This property is read-only.

Syntax

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

Property value

The name of the host adapter to which the virtual network is connected.

Error codes

Name/value Meaning
S_OK
0
 The operation was successful.
E_POINTER
0x80004003
 The parameter is NULL.
VM_E_ADAPTER_NOT_FOUND
0xA0040700
 The host Ethernet adapter to which this virtual network was connected is no longer available. The host Ethernet adapter may have been removed or disabled.
DISP_E_EXCEPTION
0x80020009
 An unexpected error has occurred.

Remarks

The virtual network adapter allows a virtual network to talk to external networks. There is normally one adapter per Ethernet adapter installed in the host machine. For example, let's say a host machine had an adapter labeled "10/100 ENET". To connect a virtual NIC to the network attached to "10/100 ENET", set the virtual network's Network HostAdapter property to "10/100 ENET" and connect the virtual NIC to this virtual network.

If the HostAdapter property is set to an empty string (""), the virtual NIC adapter is connected to the "Internal Network" or "Shared Networking (NAT)" network. Virtual NICs attached to the "Internal Network" network will have no access to external networks on the system host. However, the virtual NICs attached to this virtual network are still able to communicate with each other.

The complete list of adapters can be accessed through the IVMHostInfo::NetworkAdapters property.

Requirements

Requirement Value
Minimum supported client
 Windows 7 [desktop apps only]
Minimum supported server
 None supported
End of client support
 Windows 7
Product
 Windows Virtual PC
Header
VPCCOMInterfaces.h
IID
 IID_IVMVirtualNetwork is defined as 431cb7a1-2469-4563-b94e-38b987adca63

See also

IVMVirtualNetwork