Qt之QNetworkInterface

简述

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

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

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

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

常用接口

枚举 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”

更多参考

posted @ 2016-03-01 19:36  挨踢人啊  阅读(820)  评论(0编辑  收藏  举报