Qt之QNetworkInterface

简述

QNetworkInterface类负责提供主机的IP地址和网络接口的列表。

QNetworkInterface表示了当前程序正在运行时与主机绑定的一个网络接口。每个网络接口可能包含0个或多个IP地址，每个IP地址都可选择性地与一个子网掩码和/或一个广播地址相关联。这样的列表可以通过addressEntries()方法获得。当子网掩码或者广播地址不必要时，可以使用allAddresses()便捷函数来仅仅获得IP地址。

QNetworkInterface使用hardwareAddress()方法获取接口的硬件地址。

不是所有的操作系统都支持这些所有的特性。只有IPv4地址可以保证在所有平台上都能被这个类列举出来，尤其是IPv6地址的列举目前只支持Windows XP及相关版本、Linux、MacOS和BSDs。

• 简述
• 常用接口
• 获取所有IP地址
• 获取网络接口列表
• 更多参考

常用接口

枚举 QNetworkInterface::InterfaceFlag
标识 QNetworkInterface::InterfaceFlags

指定网络接口相关的标识，可能的值：

常量	值	描述
QNetworkInterface::IsUp	0x1	网络接口处于活动状态
QNetworkInterface::IsRunning	0x2	网络接口已分配资源
QNetworkInterface::CanBroadcast	0x4	网络接口工作在广播模式
QNetworkInterface::IsLoopBack	0x8	网络接口是环回接口：也就是说，它是一个虚拟接口，其目的是主机本身
QNetworkInterface::IsPointToPoint	0x10	网络接口是一个点对点接口：也就是说，有一个，单一的其他地址可以直接由它到达。
QNetworkInterface::CanMulticast	0x20	网络接口支持多播

注意：一个网络接口不能既是broadcast-based又是point-to-point。

InterfaceFlags类型是一个QFlags类型定义，它存储一个或InterfaceFlag的组合值。

QList<QHostAddress> allAddresses() [static]

这个便利函数返回主机上面发现的所有IP地址。相当于allInterfaces()返回的所有对象调用addressEntries()来获取QHostAddress对象列表，然后对每一个对象调用QHostAddress::ip()方法。

QList<QNetworkInterface> allInterfaces() [static]

返回的主机上找到的所有的网络接口的列表。在失败情况下，它会返回一个空列表。

QList<QNetworkAddressEntry> addressEntries() const

返回IP地址列表，这个接口具备连同与其相关的网络掩码和广播地址。

如果不需要子网掩码或广播地址的信息，可以调用allAddresses()函数来只获取IP地址。

InterfaceFlags flags() const

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

QString hardwareAddress() const

返回此接口的底层硬件地址。在以太网接口上，这将是表示MAC地址的字符串，用冒号分隔。

其他接口类型可能有硬件地址的其他类型。不应该依赖于实现这个函数返回一个有效的MAC地址。

QString humanReadableName() const

如果名称可确定，在Windows上，返回网络接口的人类可读的名称，例如：“本地连接”；如果不能，这个函数返回值与name()相同。用户可以在Windows控制面板中修改人类可读的名称，因此它可以在程序的执行过程中变化的名称。

在Unix上，此函数目前返回值总是和name()相同，因为Unix系统不存储人类可读的名称的配置。

bool isValid() const

如果此QNetworkInterface对象包含一个的有效的网络接口，则返回true。

QString QNetworkInterface::name() const

返回网络接口的名称。在Unix系统中，这是一个包含接口的类型和任选的序列号的字符串，例如：“eth0”、“lo”或者“pcn0”；在Windows中，这是一个内部ID，用户不能更改。

获取所有IP地址

通过调用便利的静态函数allAddresses()，可以返回一个QHostAddress地址列表（只能获取IP地址，没有子网掩码和广播地址的信息）。

QList<QHostAddress> list = QNetworkInterface::allAddresses();
foreach (QHostAddress address, list) {
    if (!address.isNull())
        qDebug() << "Address : " << address.toString();
}

输出如下：

Address : “fe80::550c:ab19:fb48:1c9%15”
Address : “169.254.1.201”
Address : “fe80::d086:8566:6065:8954%11”
Address : “172.18.4.165”
Address : “fe80::f864:a962:7219:f98e%16”
Address : “192.168.17.1”
Address : “fe80::8169:691f:148e:d3cb%17”
Address : “192.168.178.1”
Address : “fe80::5996:27a3:83b5:2ae7%18”
Address : “192.168.56.1”
Address : “::1”
Address : “127.0.0.1”

QHostAddress类提供一个IP地址，更多参考：Qt之QHostAddress

获取网络接口列表

通过调用便利的静态函数allInterfaces()，可以返回一个QNetworkInterface网络接口列表（通过QNetworkAddressEntry，可以获取IP地址、子网掩码和广播地址等信息）。

QList<QNetworkInterface> list = QNetworkInterface::allInterfaces();
foreach (QNetworkInterface netInterface, list) {
    if (!netInterface.isValid())
        continue;

    qDebug() << "********************";

    QNetworkInterface::InterfaceFlags flags = netInterface.flags();
    if (flags.testFlag(QNetworkInterface::IsRunning)
                && !flags.testFlag(QNetworkInterface::IsLoopBack)) {  // 网络接口处于活动状态
        qDebug() << "Device : " << netInterface.name();  // 设备名
        qDebug() << "HardwareAddress : " << netInterface.hardwareAddress();  // 硬件地址
        qDebug() << "Human Readable Name : " << netInterface.humanReadableName();  // 人类可读的名字
    }

    // QList<QNetworkAddressEntry> entryList = netInterface.addressEntries();
    // foreach(QNetworkAddressEntry entry, entryList) { // 遍历每一个IP地址
        // qDebug() << "IP Address:" << entry.ip().toString();  // IP地址
        // qDebug() << "Netmask:" << entry.netmask().toString();  // 子网掩码
        // qDebug() << "Broadcast:" << entry.broadcast().toString();  // 广播地址
    //}
}

通过flags()函数，可以获取到当前网络接口的标识，利用testFlag()进行过滤，就可以获取我们想要的内容（设备名、硬件地址、名字）。

注意：为了简单，我注释掉了IP地址的信息，需要的可以自行测试。

QNetworkAddressEntry类存储了一个IP地址，子网掩码和广播地址。更多参考：Qt之QNetworkAddressEntry

输出如下：

---

Device : “{BE9972CD-860E-4E15-8CE2-3F25EF0A7A24}”
HardwareAddress : “94:DE:80:21:92:17”
Human Readable Name : “本地连接”

---

Device : “{29F85058-E757-4F60-BF7B-47F6227C8CBC}”
HardwareAddress : “00:50:56:C0:00:01”
Human Readable Name : “VMware Network Adapter VMnet1”

---

Device : “{A297491C-D43C-4F85-A674-88368F8D4FC1}”
HardwareAddress : “00:50:56:C0:00:08”
Human Readable Name : “VMware Network Adapter VMnet8”

---

Device : “{1AE5F6FC-478A-4EAB-B4D2-86201A6B2090}”
HardwareAddress : “0A:00:27:00:00:12”
Human Readable Name : “VirtualBox Host-Only Network”

更多参考

• Qt之网络编程
• Qt之QHostInfo
• Qt之QHostAddress
• Qt之QNetworkAddressEntry