QNetworkInterface Class

Dokumentation der Mitgliederfunktionen

QNetworkInterface::QNetworkInterface()

Konstruiert ein leeres Netzwerkschnittstellenobjekt.

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

Erzeugt eine Kopie des in other enthaltenen QNetworkInterface-Objekts.

[noexcept] QNetworkInterface::~QNetworkInterface()

Gibt die Ressourcen frei, die mit dem Objekt QNetworkInterface verbunden sind.

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

Gibt die Liste der IP-Adressen, die diese Schnittstelle besitzt, zusammen mit den zugehörigen Netzmasken und Broadcast-Adressen zurück.

Wenn die Netzmaske oder die Broadcast-Adresse oder andere Informationen nicht erforderlich sind, können Sie die Funktion allAddresses() aufrufen, um nur die IP-Adressen der aktiven Schnittstellen zu erhalten.

[static] QList<QHostAddress> QNetworkInterface::allAddresses()

Diese Komfortfunktion gibt alle auf dem Host-Rechner gefundenen IP-Adressen zurück. Sie ist gleichbedeutend mit dem Aufruf von addressEntries() für alle von allInterfaces() zurückgegebenen Objekte, die sich im Zustand QNetworkInterface::IsUp befinden, um Listen von QNetworkAddressEntry Objekten zu erhalten, und dem anschließenden Aufruf von QNetworkAddressEntry::ip() für jedes dieser Objekte.

[static] QList<QNetworkInterface> QNetworkInterface::allInterfaces()

Gibt eine Auflistung aller auf dem Host-Rechner gefundenen Netzwerkschnittstellen zurück. Im Falle eines Fehlers wird eine Liste mit Nullelementen zurückgegeben.

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

Gibt die mit dieser Netzwerkschnittstelle verbundenen Flags zurück.

QString QNetworkInterface::hardwareAddress() const

Gibt die Low-Level-Hardwareadresse für diese Schnittstelle zurück. Bei Ethernet-Schnittstellen ist dies eine MAC-Adresse in String-Darstellung, getrennt durch Doppelpunkte.

Andere Schnittstellentypen können andere Arten von Hardwareadressen haben. Implementierungen sollten sich nicht darauf verlassen, dass diese Funktion eine gültige MAC-Adresse zurückgibt.

Siehe auch type().

QString QNetworkInterface::humanReadableName() const

Gibt den für Menschen lesbaren Namen dieser Netzwerkschnittstelle unter Windows zurück, z. B. "Local Area Connection", wenn der Name ermittelt werden konnte. Wenn dies nicht der Fall ist, gibt diese Funktion dasselbe zurück wie name(). Der menschenlesbare Name ist ein Name, den der Benutzer in der Windows-Systemsteuerung ändern kann, er kann sich also während der Ausführung des Programms ändern.

Unter Unix gibt diese Funktion derzeit immer dasselbe zurück wie name(), da Unix-Systeme keine Konfiguration für menschenlesbare Namen speichern.

int QNetworkInterface::index() const

Gibt den Systemindex der Schnittstelle zurück, falls bekannt. Dies ist eine ganze Zahl, die vom Betriebssystem zugewiesen wird, um diese Schnittstelle zu identifizieren, und die sich im Allgemeinen nicht ändert. Er entspricht dem Feld scope ID in IPv6-Adressen.

Wenn der Index nicht bekannt ist, gibt diese Funktion 0 zurück.

[static] QNetworkInterface QNetworkInterface::interfaceFromIndex(int index)

Gibt ein QNetworkInterface Objekt für die Schnittstelle zurück, deren interne ID index ist. Netzwerkschnittstellen haben eine eindeutige Kennung, den "Schnittstellenindex", um sie von anderen Schnittstellen im System zu unterscheiden. Oft wird dieser Wert fortlaufend zugewiesen, und Schnittstellen, die entfernt und dann wieder hinzugefügt werden, erhalten jedes Mal einen anderen Wert.

Dieser Index ist auch im Scope-ID-Feld der IPv6-Adresse zu finden.

[static] QNetworkInterface QNetworkInterface::interfaceFromName(const QString &name)

Gibt ein QNetworkInterface Objekt für die Schnittstelle mit dem Namen name zurück. Wenn keine solche Schnittstelle existiert, gibt diese Funktion ein ungültiges QNetworkInterface Objekt zurück.

Die Zeichenkette name kann entweder ein tatsächlicher Schnittstellenname (wie "eth0" oder "en1") oder ein Schnittstellenindex in Form einer Zeichenkette ("1", "2" usw.) sein.

Siehe auch name() und isValid().

[static] int QNetworkInterface::interfaceIndexFromName(const QString &name)

Gibt den Index der Schnittstelle zurück, deren Name name ist, oder 0, wenn es keine Schnittstelle mit diesem Namen gibt. Diese Funktion sollte das gleiche Ergebnis liefern wie der folgende Code, wird aber wahrscheinlich schneller ausgeführt.

    QNetworkInterface::interfaceFromName(name).index()

Siehe auch interfaceFromName(), interfaceNameFromIndex(), und QNetworkDatagram::interfaceIndex().

[static] QString QNetworkInterface::interfaceNameFromIndex(int index)

Gibt den Namen der Schnittstelle zurück, deren Index index ist, oder einen leeren String, wenn es keine Schnittstelle mit diesem Index gibt. Diese Funktion sollte das gleiche Ergebnis liefern wie der folgende Code, wird aber wahrscheinlich schneller ausgeführt.

    QNetworkInterface::interfaceFromIndex(index).name()

Siehe auch interfaceFromIndex(), interfaceIndexFromName(), und QNetworkDatagram::interfaceIndex().

bool QNetworkInterface::isValid() const

Gibt true zurück, wenn dieses QNetworkInterface Objekt gültige Informationen über eine Netzwerkschnittstelle enthält.

int QNetworkInterface::maximumTransmissionUnit() const

Gibt die maximale Übertragungseinheit auf dieser Schnittstelle zurück, wenn sie bekannt ist, oder sonst 0.

Die maximale Übertragungseinheit ist das größte Paket, das über diese Schnittstelle gesendet werden kann, ohne dass es zu einer Fragmentierung auf Link-Ebene kommt. Anwendungen können diesen Wert verwenden, um die Größe der Nutzlast zu berechnen, die in ein nicht fragmentiertes UDP-Datagramm passt. Denken Sie daran, die Größe der Header abzuziehen, die in Ihrer Kommunikation über die Schnittstelle verwendet werden, z. B. TCP (20 Byte) oder UDP (12), IPv4 (20) oder IPv6 (40, wenn keine Form der Header-Komprimierung vorhanden ist), wenn Sie berechnen, wie groß die Nutzlast ist, die Sie übertragen können. Beachten Sie auch, dass die MTU entlang des gesamten Pfades (die Pfad-MTU) zum Ziel kleiner sein kann als die MTU der Schnittstelle.

Siehe auch QUdpSocket.

QString QNetworkInterface::name() const

Gibt den Namen dieser Netzwerkschnittstelle zurück. Auf Unix-Systemen ist dies eine Zeichenkette, die den Typ der Schnittstelle und optional eine laufende Nummer enthält, z. B. "eth0", "lo" oder "pcn0". Unter Windows handelt es sich um eine interne ID, die vom Benutzer nicht geändert werden kann.

[noexcept] void QNetworkInterface::swap(QNetworkInterface &other)

Tauscht diese Netzwerkschnittstelleninstanz mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

QNetworkInterface::InterfaceType QNetworkInterface::type() const

Gibt den Typ dieser Schnittstelle zurück, sofern er ermittelt werden konnte. Konnte er nicht ermittelt werden, gibt diese Funktion QNetworkInterface::Unknown zurück.

Siehe auch hardwareAddress().

QNetworkInterface &QNetworkInterface::operator=(const QNetworkInterface &other)

Kopiert den Inhalt des Objekts QNetworkInterface, das in other enthalten ist, in dieses Objekt.