QNetworkInterface Class

Dokumentation der Mitgliedsfunktionen

QNetworkInterface::QNetworkInterface()

Erstellt ein leeres Netzwerk-Schnittstellenobjekt.

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

Erstellt eine Kopie des QNetworkInterface-Objekts, das in „ other “ enthalten ist.

[noexcept] QNetworkInterface::~QNetworkInterface()

Gibt die mit dem Objekt „ QNetworkInterface “ verbundenen Ressourcen frei.

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

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

Wenn die Netzmaske, die Broadcast-Adresse oder andere Informationen nicht benötigt werden, können Sie die Funktion ` allAddresses()` aufrufen, um nur die IP-Adressen der aktiven Schnittstellen abzurufen.

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

Diese Hilfsfunktion gibt alle auf dem Host-Rechner gefundenen IP-Adressen zurück. Sie entspricht dem Aufruf von ` addressEntries()` für alle von ` allInterfaces()` zurückgegebenen Objekte, die sich im Status „ QNetworkInterface::IsUp “ befinden, um Listen mit ` 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 Fehlerfall wird eine Liste mit null Elementen 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 handelt es sich dabei um eine MAC-Adresse in Zeichenfolgendarstellung, getrennt durch Doppelpunkte.

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

Siehe auch ` type()`.

QString QNetworkInterface::humanReadableName() const

Gibt unter Windows den für Menschen lesbaren Namen dieser Netzwerkschnittstelle zurück, z. B. „LAN-Verbindung“, sofern der Name ermittelt werden konnte. Ist dies nicht der Fall, gibt diese Funktion denselben Wert wie die Funktion „ name()“ zurück. Der für Menschen lesbare Name ist ein Name, den der Benutzer in der Windows-Systemsteuerung ändern kann; daher kann er sich während der Ausführung des Programms ändern.

Unter Unix gibt diese Funktion derzeit immer denselben Wert wie ` name()` zurück, da Unix-Systeme keine Konfiguration für für Menschen lesbare Namen speichern.

int QNetworkInterface::index() const

Gibt den Systemindex der Schnittstelle zurück, sofern bekannt. Dabei handelt es sich um eine vom Betriebssystem zugewiesene Ganzzahl zur Identifizierung dieser Schnittstelle, die sich in der Regel nicht ändert. Sie entspricht dem Feld „Scope-ID“ in IPv6-Adressen.

Ist der Index nicht bekannt, 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` lautet. Netzwerkschnittstellen verfügen über eine eindeutige Kennung, den sogenannten „Schnittstellenindex“, um sie von anderen Schnittstellen im System zu unterscheiden. Häufig wird dieser Wert fortlaufend vergeben, sodass Schnittstellen, die entfernt und anschließend wieder hinzugefügt werden, jedes Mal einen anderen Wert erhalten.

Dieser Index ist auch im Feld „Scope-ID“ 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. Falls 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 Zeichenkettenform („1“, „2“ usw.) sein.

Siehe auch name() und isValid().

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

Gibt den Index der Schnittstelle mit dem Namen „ name “ zurück oder 0, falls keine Schnittstelle mit diesem Namen vorhanden ist. Diese Funktion sollte das gleiche Ergebnis wie der folgende Code liefern, 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 “ lautet, oder eine leere Zeichenkette, falls keine Schnittstelle mit diesem Index vorhanden ist. 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 zu einer Netzwerkschnittstelle enthält.

int QNetworkInterface::maximumTransmissionUnit() const

Gibt die maximale Übertragungseinheit dieser Schnittstelle zurück, sofern bekannt, andernfalls 0.

Die maximale Übertragungseinheit ist das größte Paket, das über diese Schnittstelle gesendet werden kann, ohne dass es zu einer Fragmentierung auf Verbindungsebene 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ößen der bei Ihrer Kommunikation über die Schnittstelle verwendeten Header abzuziehen, z. B. TCP (20 Byte) oder UDP (12), IPv4 (20) oder IPv6 (40, sofern keine Form der Header-Komprimierung verwendet wird), wenn Sie berechnen, wie groß die Nutzdaten sein können, die Sie übertragen können. Beachten Sie außerdem, 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 handelt es sich dabei um eine Zeichenkette, die den Typ der Schnittstelle und optional eine fortlaufende Nummer enthält, beispielsweise „eth0“, „lo“ oder „pcn0“. Unter Windows ist es eine interne ID, die vom Benutzer nicht geändert werden kann.

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

Tauscht diese Netzwerk-Schnittstelleninstanz gegen „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.

QNetworkInterface::InterfaceType QNetworkInterface::type() const

Gibt den Typ dieser Schnittstelle zurück, sofern dieser ermittelt werden konnte. Konnte der Typ 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.