QNetworkInterface Class

Documentación de las funciones de los miembros

QNetworkInterface::QNetworkInterface()

Construye un objeto de interfaz de red vacío.

QNetworkInterface::QNetworkInterface(const QNetworkInterface &other)

Crea una copia del objeto QNetworkInterface contenido en other.

[noexcept] QNetworkInterface::~QNetworkInterface()

Libera los recursos asociados al objeto QNetworkInterface.

QList<QNetworkAddressEntry> QNetworkInterface::addressEntries() const

Devuelve la lista de direcciones IP que posee esta interfaz junto con sus máscaras de red y direcciones de difusión asociadas.

Si la máscara de red o la dirección de difusión u otra información no es necesaria, puede llamar a la función allAddresses() para obtener sólo las direcciones IP de las interfaces activas.

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

Esta función devuelve todas las direcciones IP encontradas en la máquina anfitriona. Es equivalente a llamar a addressEntries() en todos los objetos devueltos por allInterfaces() que están en el estado QNetworkInterface::IsUp para obtener listas de objetos QNetworkAddressEntry y luego llamar a QNetworkAddressEntry::ip() en cada uno de ellos.

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

Devuelve un listado de todas las interfaces de red encontradas en la máquina anfitriona. En caso de fallo devuelve una lista con cero elementos.

QNetworkInterface::InterfaceFlags QNetworkInterface::flags() const

Devuelve las banderas asociadas a esta interfaz de red.

QString QNetworkInterface::hardwareAddress() const

Devuelve la dirección de hardware de bajo nivel de esta interfaz. En interfaces Ethernet, será una dirección MAC en representación de cadena, separada por dos puntos.

Otros tipos de interfaz pueden tener otros tipos de direcciones de hardware. Las implementaciones no deberían depender de que esta función devuelva una dirección MAC válida.

Véase también type().

QString QNetworkInterface::humanReadableName() const

Devuelve el nombre legible por humanos de esta interfaz de red en Windows, como "Conexión de área local", si se pudo determinar el nombre. Si no se pudo, esta función devuelve lo mismo que name(). El nombre legible por humanos es un nombre que el usuario puede modificar en el Panel de Control de Windows, por lo que puede cambiar durante la ejecución del programa.

En Unix, esta función actualmente siempre devuelve lo mismo que name(), ya que los sistemas Unix no almacenan una configuración para nombres legibles por humanos.

int QNetworkInterface::index() const

Devuelve el índice de sistema de la interfaz, si se conoce. Se trata de un número entero asignado por el sistema operativo para identificar esta interfaz y generalmente no cambia. Coincide con el campo scope ID de las direcciones IPv6.

Si no se conoce el índice, esta función devuelve 0.

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

Devuelve un objeto QNetworkInterface para la interfaz cuyo ID interno es index. Las interfaces de red tienen un identificador único llamado "índice de interfaz" para distinguirla de otras interfaces del sistema. A menudo, este valor se asigna progresivamente y las interfaces que se eliminan y se vuelven a añadir obtienen un valor diferente cada vez.

Este índice también se encuentra en el campo scope ID de la dirección IPv6.

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

Devuelve un objeto QNetworkInterface para la interfaz denominada name. Si no existe tal interfaz, esta función devuelve un objeto QNetworkInterface inválido.

La cadena name puede ser un nombre de interfaz real (como "eth0" o "en1") o un índice de interfaz en forma de cadena ("1", "2", etc.).

Véase también name() y isValid().

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

Devuelve el índice de la interfaz cuyo nombre es name o 0 si no hay ninguna interfaz con ese nombre. Esta función debería producir el mismo resultado que el código siguiente, pero probablemente se ejecutará más rápido.

    QNetworkInterface::interfaceFromName(name).index()

Véase también interfaceFromName(), interfaceNameFromIndex(), y QNetworkDatagram::interfaceIndex().

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

Devuelve el nombre de la interfaz cuyo índice es index o una cadena vacía si no hay ninguna interfaz con ese índice. Esta función debería producir el mismo resultado que el código siguiente, pero probablemente se ejecutará más rápido.

    QNetworkInterface::interfaceFromIndex(index).name()

Véase también interfaceFromIndex(), interfaceIndexFromName(), y QNetworkDatagram::interfaceIndex().

bool QNetworkInterface::isValid() const

Devuelve true si este objeto QNetworkInterface contiene información válida sobre una interfaz de red.

int QNetworkInterface::maximumTransmissionUnit() const

Devuelve la unidad de transmisión máxima en esta interfaz, si se conoce, o 0 en caso contrario.

La unidad de transmisión máxima es el paquete más grande que se puede enviar en esta interfaz sin incurrir en fragmentación a nivel de enlace. Las aplicaciones pueden utilizar este valor para calcular el tamaño de la carga útil que cabe en un datagrama UDP sin fragmentar. Recuerde restar los tamaños de las cabeceras utilizadas en su comunicación a través de la interfaz, por ejemplo, TCP (20 bytes) o UDP (12), IPv4 (20) o IPv6 (40, en ausencia de alguna forma de compresión de cabecera), cuando calcule el tamaño de la carga útil que puede transmitir. Ten en cuenta también que la MTU a lo largo de toda la ruta (la Path MTU) hasta el destino puede ser menor que la MTU de la interfaz.

Véase también QUdpSocket.

QString QNetworkInterface::name() const

Devuelve el nombre de esta interfaz de red. En sistemas Unix, es una cadena que contiene el tipo de interfaz y, opcionalmente, un número de secuencia, como "eth0", "lo" o "pcn0". En Windows, es un ID interno que no puede ser cambiado por el usuario.

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

Intercambia esta instancia de interfaz de red con other. Esta operación es muy rápida y nunca falla.

QNetworkInterface::InterfaceType QNetworkInterface::type() const

Devuelve el tipo de esta interfaz, si se ha podido determinar. Si no se ha podido determinar, esta función devuelve QNetworkInterface::Unknown.

Véase también hardwareAddress().

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

Copia el contenido del objeto QNetworkInterface contenido en other en éste.