一、描述

QNetworkInterface 代表一个连接到运行程序的主机网络接口。每个网络接口可能包含零个或多个 IP 地址,每个 IP 地址都可选地与网络掩码和/或广播地址相关联。

此类封装的数据如下:

QNetworkAccessManager ftp 目录下载 qnetworkinterface_网络接口

二、类型成员

1、QNetworkInterface::InterfaceFlag:指定与网络接口关联的标志。

  • IsUp:网络接口处于活动状态。
  • IsRunning:网络接口已分配资源。
  • CanBroadcast:网络接口工作在广播模式。
  • IsLoopBack:网络接口是一个环回接口。即它是一个虚拟接口,其目的地是主机本身。
  • IsPointToPoint:网络接口是一个点对点接口。即它可以直接到达一个单独的其他地址。
  • CanMulticast:网络接口支持组播。

注意,一个网络接口不能既是基于广播的又是点对点的。

2、QNetworkInterface::InterfaceType:此接口的硬件类型(OSI的第一层:物理层)。不在下面列出的接口类型中的接口类型通常会列为未知。

  • Unknown:接口类型无法确定或不是其他列出的类型之一。
  • Loopback:虚拟环回接口,分配了环回 IP 地址 (127.0.0.1, ::1)。
  • Virtual:虚拟的接口类型,不是任何其他可能的类型。
  • Ethernet:IEEE 802.3 以太网接口。
  • Wifi:IEEE 802.11 Wi-Fi 接口。
  • Ieee80211:WiFi 的别名。
  • CanBus:ISO 11898 控制器局域网总线接口。
  • Fddi:ANSI X3T12 光纤分布式数据接口,一种光纤局域网。
  • Ppp:点对点协议接口,通过较低的传输层(通常通过无线电或物理线路串行)在两个节点之间建立直接连接。
  • Slip:串行线路互联网协议接口。
  • Phonet:使用 Linux Phonet socket系列的接口,用于与蜂窝调制解调器通信。
  • Ieee802154:IEEE 802.15.4 个人区域网络接口,6LoWPAN 除外。
  • SixLoWPAN:6LoWPAN(低功耗无线个人区域网络上的 IPv6)接口,通常用于网状网络。
  • Ieee80216:IEEE 802.16 无线城域网。
  • Ieee1394:IEEE 1394 接口(又名“FireWire”)。

三、成员函数

1、QList<QNetworkAddressEntry> addressEntries()

返回此接口拥有的 IP 地址列表及其关联的网络掩码和广播地址。

如果不需要网络掩码或广播地址或其他信息,则可以调用 allAddresses() 函数以仅获取活动接口的 IP 地址。

foreach(auto & interface,QNetworkInterface::allInterfaces())  //遍历每一个网络接口
    {
        foreach(const QNetworkAddressEntry & entry,interface.addressEntries())  //遍历每一个IP地址条目
        {
            qDebug()<<"IP地址:"<<entry.ip().toString();
            qDebug()<<"子网掩码:"<<entry.netmask().toString();
            qDebug()<<"广播地址:"<<entry.broadcast().toString();
        }
    }

 2、[static] QList<QHostAddress> allAddresses()

返回在主机上找到的所有 IP 地址。

foreach (const QHostAddress & addr, QNetworkInterface::allAddresses())
    {
        qDebug()<<addr;
    }

 

QNetworkAccessManager ftp 目录下载 qnetworkinterface_IP_02

3、[static] QList<QNetworkInterface> allInterfaces()

返回主机上找到的所有网络接口的列表。

foreach (const QNetworkInterface & interface, QNetworkInterface::allInterfaces())
    {
        qDebug()<<interface;
    }

QNetworkAccessManager ftp 目录下载 qnetworkinterface_IP_03

flags()

返回与此网络接口关联的标志。

5、QString hardwareAddress()

返回此接口的低级硬件地址。 在以太网接口上,这将是字符串表示的 MAC 地址,用冒号分隔。其他接口类型可能具有其他类型的硬件地址。(见上图)

6、QString humanReadableName()

可读名称。如果可以确定名称,则返回此网络接口在 Windows 上的可读名称,例如“本地连接”。如果不能,此函数返回与 name() 相同的值。可读名称是用户可以在 Windows 控制面板中修改的名称,因此它可能会在程序执行过程中更改。在 Unix 上,此函数当前始终返回与 name() 相同的值,因为 Unix 系统不存储可读名称的配置。

foreach (const QNetworkInterface & interface, QNetworkInterface::allInterfaces())
    {
        qDebug()<<interface.humanReadableName()<<interface.name();
    }

 

QNetworkAccessManager ftp 目录下载 qnetworkinterface_网络接口_04

7、int index()

如果已知,则返回接口系统索引。这是操作系统分配的一个整数,用于标识此接口,它通常不会更改。它与 IPv6 地址中的作用域 ID 字段相匹配。如果索引未知,则此函数返回 0。

8、[static] QNetworkInterface interfaceFromIndex(int index)

返回内部 ID 为index的主机网络接口对象。

9、[static] QNetworkInterface interfaceFromName(const QString &name)

返回名为 name 的主机网络接口对象。

10、[static] int interfaceIndexFromName(const QString &name)

 返回名称为 name 的接口的索引,如果没有该名称的接口,则返回 0。

11、[static] QString interfaceNameFromIndex(int index)

 返回索引为 index 的接口的名称,如果没有具有该索引的接口,则返回空字符串。

12、bool isValid()

对象是否包含有关网络接口的有效信息。

maximumTransmissionUnit() 

返回此接口上的最大传输单元(如果已知),否则返回 0。

14、QString name()

返回此网络接口的名称。在 Unix 系统上,这是一个包含接口类型和可选序列号的字符串,例如“eth0”、“lo”或“pcn0”。 在 Windows 上,它是用户无法更改的内部 ID。