一、描述
QNetworkInterface 代表一个连接到运行程序的主机网络接口。每个网络接口可能包含零个或多个 IP 地址,每个 IP 地址都可选地与网络掩码和/或广播地址相关联。
此类封装的数据如下:
二、类型成员
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;
}
3、[static] QList<QNetworkInterface> allInterfaces()
返回主机上找到的所有网络接口的列表。
foreach (const QNetworkInterface & interface, QNetworkInterface::allInterfaces())
{
qDebug()<<interface;
}
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();
}
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。