System.GetNetworkInterface

From Xojo Documentation

You are currently browsing the old Xojo documentation site. Please visit the new Xojo documentation site!
Method

System.GetNetworkInterface([Index as Integer]) As NetworkInterface

New in 5.5

Supported for all project types and targets.

Use the NetworkInterface object to obtain networking information about the user's computer.

Notes

Use the optional parameter to specify the network interface card. Index is zero-based. If Index is out of bounds, an OutOfBoundsException is raised. NetworkInterfaceCount gives you the number of network interfaces in the computer.

Sample Code

The following simple example displays the IP address, Subnet mask, and Mac address for the selected network interface. At start-up, the application detects all the network interfaces installed on the user’s computer and loads them into a PopupMenu. The user then selects the desired network interface and the values are displayed in TextFields.

The PopupMenu's Open event handler is:

For i As Integer = 0 To System.NetworkInterfaceCount - 1
PopupMenu1.AddRow(Str(i))
Next

The Change event handler for the PopupMenu is this:

Sub Change()
If Me.ListIndex > -1 Then
// Get the NetworkInterface object for the selected item
Dim iface As NetworkInterface = System.GetNetworkInterface(Me.ListIndex)
MacAddressField.Text = iface.MACAddress
IPAddressField.Text = iface.IPAddress
SubnetMaskField.Text = iface.SubnetMask
End If
End Sub