Home · All Classes · Modules  · QSS HELP  · QSS 案例 · VER007 HOME

QNetworkInterface Class Reference
^{[QtNetwork module]}

该QNetworkInterface类提供​​主机的IP地址和网络接口的列表。More...

Types

• enum InterfaceFlag { IsUp, IsRunning, CanBroadcast, IsLoopBack, IsPointToPoint, CanMulticast }
• class InterfaceFlags

Methods

• __init__ (self)
• __init__ (self, QNetworkInterface other)
• list-of-QNetworkAddressEntry addressEntries (self)
• InterfaceFlags flags (self)
• QString hardwareAddress (self)
• QString humanReadableName (self)
• int index (self)
• bool isValid (self)
• QString name (self)

Static Methods

• list-of-QHostAddress allAddresses ()
• list-of-QNetworkInterface allInterfaces ()
• QNetworkInterface interfaceFromIndex (int index)
• QNetworkInterface interfaceFromName (QString name)

Detailed Description

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

QNetworkInterface表示连接到该程序正在运行主机一个网络接口。每个网络接口可以包含零个或多个IP地址，其中每一个与一个掩码和/或广播地址是任选关联。可以得到这样的三重奏列表addressEntries（ ） 。或者，当网络掩码或广播地址是没有必要的，使用allAddresses（ ）方便的功能，仅仅获得了IP地址。

QNetworkInterface还报告与接口的硬件地址hardwareAddress（ ） 。

并非所有操作系统都支持报告的所有功能。只有IPv4地址，保证在所有平台上被列入这个类别。特别是， IPv6地址的清单只支持Windows XP和更新的版本， Linux的， MacOS X和BSD系统。

Type Documentation

QNetworkInterface.InterfaceFlag

指定与此网络接口关联的标志。可能的值有：

请注意，一个网络接口不能同时基于广播和点至点。

该InterfaceFlags类型是一个typedef为QFlags\u003cInterfaceFlag\u003e 。它存储InterfaceFlag值的或组合。

Method Documentation

QNetworkInterface.__init__ (self)

构造一个空的网络接口对象。

QNetworkInterface.__init__ (self, QNetworkInterface other)

创建的副本QNetworkInterface包含的对象other。

list-of-QNetworkAddressEntry QNetworkInterface.addressEntries (self)

返回的IP地址列表，该接口具有与它们相关的子网掩码和广播地址。

如果网络掩码或广播地址的信息是没有必要的，你可以调用allAddresses（ ）函数来获得公正的IP地址。

list-of-QHostAddress QNetworkInterface.allAddresses ()

这种便利函数返回的主机上找到的所有IP地址。这等同于调用addressEntries（ ）对所有返回的对象allInterfaces（）获得的列表QHostAddress对象然后调用QHostAddress.ip （ ）在每个这些。

list-of-QNetworkInterface QNetworkInterface.allInterfaces ()

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

InterfaceFlags QNetworkInterface.flags (self)

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

QString QNetworkInterface.hardwareAddress (self)

返回低级别的硬件地址为这个接口。在以太网接口，这将是一个MAC地址的字符串表示形式，由冒号分隔。

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

QString QNetworkInterface.humanReadableName (self)

返回在Windows上，如“本地连接” ，如果该名称可确定此网络接口的可读名称。如果不能，则该函数返回相同name（ ） 。人类可读的名称是一个名称，用户可以在Windows控制面板中修改，所以它可以在程序执行期间改变。

在Unix中，这个功能目前总是返回相同name（ ） ，因为Unix系统都配置不存储为人类可读的名称。

此功能被引入Qt的4.5 。

int QNetworkInterface.index (self)

返回接口系统索引，如果知道的话。这是分配由操作系统来识别这个接口，它通常不发生变化的整数。它在IPv6地址匹配的范围ID字段。

如果索引不知道，这个函数返回0 。

此功能被引入Qt的4.5 。

QNetworkInterface QNetworkInterface.interfaceFromIndex (int index)

返回QNetworkInterface为对象的内部ID是接口index。网络接口具有所谓的“接口索引”，以从其他接口区分开来在系统上的唯一标识符。通常，这个值是逐步分配和被移除的接口，然后再加入每一次得到不同的值。

该指数还发现，在IPv6地址“范围ID字段。

QNetworkInterface QNetworkInterface.interfaceFromName (QString name)

返回QNetworkInterface对象命名接口name。如果没有这样的接口存在，该函数返回一个无效的QNetworkInterface对象。

See also name（）和isValid（ ） 。

bool QNetworkInterface.isValid (self)

返回True如果QNetworkInterface对象包含一个网络接口的有效信息。

QString QNetworkInterface.name (self)

返回此网络接口的名称。在Unix系统中，这是一个包含接口的类型和任选的序列号，如“ eth0的”，“ LO ”或“ pcn0 ”的字符串。在Windows上，它是不能被用户改变的内部ID 。