IVMNetworkAdapter interface
[Windows Virtual PC is no longer available for use as of Windows 8. Instead, use the Hyper-V WMI provider (V2).]
Serves as the interface to a virtual network interface card (NIC). It is used to set up how a virtual machine is networked. Network interface cards can be added and removed by using IVMVirtualMachine::AddNetworkAdapter and IVMVirtualMachine::RemoveNetworkAdapter. You can also retrieve an IVMNetworkAdapter object from the IVMNetworkAdapterCollection collection returned from the IVMVirtualMachine::NetworkAdapters or IVMVirtualNetwork::NetworkAdapters properties.
Members
The IVMNetworkAdapter interface inherits from the IDispatch interface. IVMNetworkAdapter also has these types of members:
Methods
The IVMNetworkAdapter interface has these methods.
Method | Description |
---|---|
_ID | Retrieves the internal identifier of this network interface. |
AttachToVirtualNetwork | Attaches the network interface to the specified virtual network. |
DetachFromVirtualNetwork | Detaches the network interface from its virtual network. |
Properties
The IVMNetworkAdapter interface has these properties.
Property | Access type | Description |
---|---|---|
EthernetAddress |
Read/write |
The Ethernet (MAC) address of the network interface. |
IsEthernetAddressDynamic |
Read/write |
Indicates whether the Ethernet address is dynamically generated. |
VirtualMachine |
Read-only |
The virtual machine associated with this network interface. |
VirtualNetwork |
Read-only |
The virtual network to which the network interface is attached. |
Remarks
The default Ethernet address for a network interface is "00-00-00-00-00-00", which is considered an invalid Ethernet address by most operating systems. If IsEthernetAddressDynamic is set to FALSE, EthernetAddress must be initialized with a valid Ethernet network address.
The following procedures explain how to use the IVMNetworkAdapter interface.
To attach a virtual NIC to a host NIC
- Virtual (guest) NICs are not attached directly to a host NIC. Instead, the virtual NIC is attached to a virtual network that is attached to a host NIC. For more information about configuring virtual networks, see IVMVirtualNetwork. To attach the virtual NIC to a virtual network, use the AttachToVirtualNetwork method.
To disconnect a virtual NIC from the virtual network
- The DetachFromVirtualNetwork method will detach the virtual NIC from the virtual network. After this function is called, the VirtualNetwork property will return a virtual network ID that is not valid.
To remove a virtual NIC from a virtual machine if you have the virtual NIC object
- Get the virtual machine associated with the virtual NIC by using the VirtualMachine property.
- Use the current object as a parameter to the IVMVirtualMachine::RemoveNetworkAdapter method.
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 |
|
IID |
IID_IVMNetworkAdapter is defined as e32e4165-22b8-4dc0-8d57-850171ae207a |
Σχόλια
https://aka.ms/ContentUserFeedback.
Σύντομα διαθέσιμα: Καθ' όλη τη διάρκεια του 2024 θα καταργήσουμε σταδιακά τα ζητήματα GitHub ως μηχανισμό ανάδρασης για το περιεχόμενο και θα το αντικαταστήσουμε με ένα νέο σύστημα ανάδρασης. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα:Υποβολή και προβολή σχολίων για