IVMNetworkAdapter::AttachToVirtualNetwork method

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

Attaches the network interface to the specified virtual network.

Syntax

HRESULT AttachToVirtualNetwork(
  [in] IVMVirtualNetwork *virtualNetwork
);

virtualNetwork [in]: The virtual network to which this virtual NIC will be connected. See IVMVirtualNetwork.

This method can return one of these values.

Return code/value	Description
S_OK	The operation was successful.
E_POINTER 0x80004003	The parameter is NULL.
E_INVALIDARG 0x80000003	The parameter does not contain a valid virtual network.
HRESULT_FROM_WIN32(ERROR_ACCESS_DENIED) 0x80070005	Access was denied to the requested virtual network.
VM_E_VM_UNKNOWN 0xA0040207	The virtual machine is invalid or no longer exists.
VM_E_INVALID_VIRTUAL_NETWORK_ID	The parameter is not an existing virtual network.
DISP_E_EXCEPTION	An unexpected error has occurred.

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_IVMNetworkAdapter is defined as e32e4165-22b8-4dc0-8d57-850171ae207a