En esta página

QDnsLookup Class

La clase QDnsLookup representa una consulta DNS. Más información...

Encabezado: #include <QDnsLookup>
CMake: find_package(Qt6 REQUIRED COMPONENTS Network)
target_link_libraries(mytarget PRIVATE Qt6::Network)
qmake: QT += network
Heredan: QObject

Tipos públicos

enum Error { NoError, ResolverError, OperationCancelledError, InvalidRequestError, InvalidReplyError, …, TimeoutError }
enum Protocol { Standard, DnsOverTls }
enum Type { A, AAAA, ANY, CNAME, MX, …, TXT }

Propiedades

Funciones públicas

QDnsLookup(QObject *parent = nullptr)
QDnsLookup(QDnsLookup::Type type, const QString &name, QObject *parent = nullptr)
QDnsLookup(QDnsLookup::Type type, const QString &name, const QHostAddress &nameserver, QObject *parent = nullptr)
(since 6.6) QDnsLookup(QDnsLookup::Type type, const QString &name, const QHostAddress &nameserver, quint16 port, QObject *parent = nullptr)
(since 6.8) QDnsLookup(QDnsLookup::Type type, const QString &name, QDnsLookup::Protocol protocol, const QHostAddress &nameserver, quint16 port = 0, QObject *parent = nullptr)
virtual ~QDnsLookup()
QBindable<QString> bindableName()
QBindable<QHostAddress> bindableNameserver()
QBindable<quint16> bindableNameserverPort()
QBindable<QDnsLookup::Protocol> bindableNameserverProtocol()
QBindable<QDnsLookup::Type> bindableType()
QList<QDnsDomainNameRecord> canonicalNameRecords() const
QDnsLookup::Error error() const
QString errorString() const
QList<QDnsHostAddressRecord> hostAddressRecords() const
bool isAuthenticData() const
bool isFinished() const
QList<QDnsMailExchangeRecord> mailExchangeRecords() const
QString name() const
QList<QDnsDomainNameRecord> nameServerRecords() const
QHostAddress nameserver() const
quint16 nameserverPort() const
QDnsLookup::Protocol nameserverProtocol() const
QList<QDnsDomainNameRecord> pointerRecords() const
QList<QDnsServiceRecord> serviceRecords() const
void setName(const QString &name)
void setNameserver(const QHostAddress &nameserver)
void setNameserver(QDnsLookup::Protocol protocol, const QHostAddress &nameserver, quint16 port = 0)
(since 6.6) void setNameserver(const QHostAddress &nameserver, quint16 port)
void setNameserverPort(quint16 port)
void setNameserverProtocol(QDnsLookup::Protocol protocol)
(since 6.8) void setSslConfiguration(const QSslConfiguration &sslConfiguration)
void setType(QDnsLookup::Type)
QSslConfiguration sslConfiguration() const
QList<QDnsTextRecord> textRecords() const
(since 6.8) QList<QDnsTlsAssociationRecord> tlsAssociationRecords() const
QDnsLookup::Type type() const

Ranuras públicas

void abort()
void lookup()

Señales

void finished()
void nameChanged(const QString &name)
void nameserverChanged(const QHostAddress &nameserver)
void nameserverPortChanged(quint16 port)
void nameserverProtocolChanged(QDnsLookup::Protocol protocol)
void typeChanged(QDnsLookup::Type type)

Miembros públicos estáticos

(since 6.8) quint16 defaultPortForProtocol(QDnsLookup::Protocol protocol)
(since 6.8) bool isProtocolSupported(QDnsLookup::Protocol protocol)

Descripción detallada

QDnsLookup utiliza los mecanismos que proporciona el sistema operativo para realizar búsquedas DNS. Para realizar una búsqueda, es necesario especificar un « name » y un « type » y, a continuación, invocar la ranura « lookup()». La señal « finished()» se emitirá una vez finalizada la búsqueda.

Por ejemplo, puedes determinar a qué servidores debe conectarse un cliente de chat XMPP para un dominio determinado con:

void MyObject::lookupServers()
{
    // Create a DNS lookup.
    dns = new QDnsLookup(this);
    connect(dns, &QDnsLookup::finished, this, &MyObject::handleServers);

    // Find the XMPP servers for gmail.com
    dns->setType(QDnsLookup::SRV);
    dns->setName("_xmpp-client._tcp.gmail.com");
    dns->lookup();
}

Una vez finalizada la solicitud, puedes gestionar los resultados con:

void MyObject::handleServers()
{
    // Comprueba si la búsqueda se ha realizado correctamente.
    if (dns->error() != QDnsLookup::NoError) {
        qWarning("DNS lookup failed");
        dns->deleteLater();
        return;
    }

    // Gestionar los resultados.
    const auto records = dns->serviceRecords();
    for (const QDnsServiceRecord&record: records) {
        ...
    }
    dns->deleteLater();
}

Nota: Si simplemente quieres encontrar las direcciones IP asociadas a un nombre de host, o el nombre de host asociado a una dirección IP, deberías utilizar QHostInfo en su lugar.

DNS sobre TLS y datos de autenticación

QDnsLookup admite DNS sobre TLS (DoT, tal y como se especifica en el RFC 7858) en algunas plataformas. Actualmente, esto incluye todas las plataformas Unix en las que se admiten consultas normales, siempre que Qt incluya compatibilidad con QSslSocket. Para comprobar si existe compatibilidad en tiempo de ejecución, utiliza isProtocolSupported().

Al utilizar DNS sobre TLS, QDnsLookup solo implementa el método de autenticación «Opportunistic Privacy Profile», tal y como se describe en la sección 4.1 del RFC 7858. En este modo, QDnsLookup (a través de ` QSslSocket`) solo comprueba que el servidor presente un certificado válido para el servidor al que se está conectando. Los clientes pueden utilizar ` setSslConfiguration()` para imponer restricciones adicionales y ` sslConfiguration()` para obtener información una vez completada la consulta.

QDnsLookup solicitará a los servidores DNS consultados a través de TLS que realicen una autenticación de los datos que devuelven. Si confirman que los datos son válidos, la propiedad authenticData se establecerá en «true». QDnsLookup no verifica por sí mismo la integridad de los datos, por lo que las aplicaciones solo deben confiar en esta propiedad en el caso de servidores cuya fiabilidad hayan confirmado por otros medios.

Datos auténticos sin TLS

QDnsLookup solicita datos auténticos para cualquier servidor en el que se haya establecido setNameserver(), incluso si no se requiere cifrado TLS. Esto resulta útil al consultar un servidor de nombres con caché ubicado en el mismo host que la aplicación o en una red de confianza. Aunque es similar al caso de TLS, la aplicación es responsable de determinar si el servidor que ha elegido utilizar es de confianza y si la conexión sin cifrar no puede ser manipulada.

QDnsLookup sigue la configuración del sistema para solicitar datos auténticos en el servidor de nombres predeterminado (es decir, si no se llama a ` setNameserver()`). Actualmente, esto solo es compatible con sistemas Linux que utilicen glibc 2.31 o posterior. En cualquier otro sistema, QDnsLookup ignorará el bit AD en el encabezado de la consulta.

Documentación sobre los tipos de miembro

enum QDnsLookup::Error

Indica todas las posibles condiciones de error detectadas durante el procesamiento de la consulta DNS.

ConstanteValorDescripción
QDnsLookup::NoError0No se ha producido ningún error.
QDnsLookup::ResolverError1Se ha producido un error al inicializar el resolutor DNS del sistema.
QDnsLookup::OperationCancelledError2La búsqueda se ha abortado mediante el método abort().
QDnsLookup::InvalidRequestError3La consulta DNS solicitada no era válida.
QDnsLookup::InvalidReplyError4La respuesta devuelta por el servidor no era válida.
QDnsLookup::ServerFailureError5El servidor ha detectado un fallo interno al procesar la solicitud (SERVFAIL).
QDnsLookup::ServerRefusedError6El servidor se ha negado a procesar la solicitud por motivos de seguridad o por políticas (REFUSED).
QDnsLookup::NotFoundError7El nombre de dominio solicitado no existe (NXDOMAIN).
QDnsLookup::TimeoutError8No se pudo contactar con el servidor o este no respondió a tiempo (desde la versión 6.6).

enum QDnsLookup::Protocol

Indica el tipo de servidor DNS al que se está realizando la consulta.

ConstanteValorDescripción
QDnsLookup::Standard0DNS normal, sin cifrar, que utiliza UDP y recurre a TCP cuando es necesario (puerto predeterminado: 53)
QDnsLookup::DnsOverTls1DNS cifrado sobre TLS (DoT, según lo especificado en RFC 7858), sobre TCP (puerto predeterminado: 853)

Véase también isProtocolSupported(), nameserverProtocol y setNameserver().

enum QDnsLookup::Type

Indica el tipo de consulta DNS que se ha realizado.

ConstanteValorDescripción
QDnsLookup::A1Registros de direcciones IPv4.
QDnsLookup::AAAA28Registros de direcciones IPv6.
QDnsLookup::ANY255Cualquier registro.
QDnsLookup::CNAME5Registros de nombre canónico.
QDnsLookup::MX15Registros de intercambio de correo.
QDnsLookup::NS2registros de servidor de nombres.
QDnsLookup::PTR12registros de puntero.
QDnsLookup::SRV33registros de servicio.
QDnsLookup::TLSA (since Qt 6.8)52registros de asociación TLS.
QDnsLookup::TXT16registros de texto.

Documentación de propiedades

[read-only, since 6.8] authenticData : bool

Esta propiedad indica si la respuesta fue autenticada por el resolutor.

QDnsLookup No realiza la autenticación por sí misma. En su lugar, confía en que el servidor de nombres al que se ha realizado la consulta lleve a cabo la autenticación y la comunique. La aplicación es responsable de determinar si los servidores que ha configurado con setNameserver() son fiables; si no se ha establecido ningún servidor, QDnsLookup sigue la configuración del sistema en cuanto a si se debe confiar en las respuestas.

Esta propiedad se puede establecer incluso si error() indica que se ha producido un error del resolutor.

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

bool isAuthenticData() const

Señal de notificador:

void finished()

Véase también setNameserver() y nameserverProtocol().

[read-only] error : Error

Esta propiedad contiene el tipo de error que se produjo si falló la búsqueda de DNS, o bien NoError.

Funciones de acceso:

QDnsLookup::Error error() const

Señal del notificador:

void finished()

[read-only] errorString : QString

Esta propiedad contiene una descripción legible para el usuario del error en caso de que falle la consulta de DNS.

Funciones de acceso:

QString errorString() const

Señal de notificación:

void finished()

[bindable] name : QString

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el nombre que se va a buscar.

Si el nombre que se va a buscar está vacío, QDnsLookup intentará resolver el dominio raíz del DNS. Esa consulta se suele realizar con QDnsLookup::type establecido en NS.

Nota: El nombre se codificará mediante IDNA, lo que significa que no es adecuado para consultar registros SRV compatibles con la especificación DNS-SD.

Funciones de acceso:

QString name() const
void setName(const QString &name)

Señal de notificación:

void nameChanged(const QString &name)

[bindable] nameserver : QHostAddress

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el servidor de nombres que se utilizará para la consulta DNS.

Funciones de acceso:

QHostAddress nameserver() const
void setNameserver(const QHostAddress &nameserver)
void setNameserver(QDnsLookup::Protocol protocol, const QHostAddress &nameserver, quint16 port = 0)
void setNameserver(const QHostAddress &nameserver, quint16 port)

Señal de notificador:

void nameserverChanged(const QHostAddress &nameserver)

[bindable, since 6.6] nameserverPort : quint16

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el número de puerto del servidor de nombres que se utilizará para la búsqueda de DNS.

El valor 0 indica que QDnsLookup debe utilizar el puerto predeterminado para el servidor de nombres de dominio ( nameserverProtocol).

Nota: Establecer el número de puerto en cualquier valor distinto del predeterminado (53) puede provocar que falle la resolución de nombres, dependiendo de las limitaciones del sistema operativo y de los cortafuegos, si se utiliza nameserverProtocol() para QDnsLookup::Standard. Cabe destacar que la API de Windows utilizada por QDnsLookup no es capaz de gestionar números de puerto alternativos.

Esta enumeración se introdujo en Qt 6.6.

Funciones de acceso:

quint16 nameserverPort() const
void setNameserverPort(quint16 port)

Señal del notificador:

void nameserverPortChanged(quint16 port)

[bindable, since 6.8] nameserverProtocol : Protocol

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el protocolo que se debe utilizar al enviar la consulta DNS

Esta enumeración se introdujo en Qt 6.8.

Funciones de acceso:

QDnsLookup::Protocol nameserverProtocol() const
void setNameserverProtocol(QDnsLookup::Protocol protocol)

Señal de notificación:

void nameserverProtocolChanged(QDnsLookup::Protocol protocol)

Véase también isProtocolSupported().

[bindable] type : Type

Nota: Esta propiedad admite enlaces de tipo « QProperty ».

Esta propiedad contiene el tipo de búsqueda DNS.

Funciones de acceso:

QDnsLookup::Type type() const
void setType(QDnsLookup::Type)

Señal del notificador:

void typeChanged(QDnsLookup::Type type)

Documentación de las funciones de miembro

[explicit] QDnsLookup::QDnsLookup(QObject *parent = nullptr)

Crea un objeto QDnsLookup y establece parent como objeto principal.

La propiedad type tendrá por defecto el valor QDnsLookup::A.

QDnsLookup::QDnsLookup(QDnsLookup::Type type, const QString &name, QObject *parent = nullptr)

Crea un objeto QDnsLookup para los valores proporcionados de « type » y « name », y establece « parent » como objeto padre.

QDnsLookup::QDnsLookup(QDnsLookup::Type type, const QString &name, const QHostAddress &nameserver, QObject *parent = nullptr)

Crea un objeto QDnsLookup para realizar una consulta sobre name del tipo de registro type, utilizando el servidor DNS nameserver que se ejecuta en el puerto DNS predeterminado, y establece parent como objeto padre.

[since 6.6] QDnsLookup::QDnsLookup(QDnsLookup::Type type, const QString &name, const QHostAddress &nameserver, quint16 port, QObject *parent = nullptr)

Crea un objeto QDnsLookup para realizar una consulta sobre name del tipo de registro type, utilizando el servidor DNS nameserver que se ejecuta en el puerto port, y establece parent como objeto padre.

Nota: Establecer el número de puerto en cualquier valor distinto del predeterminado (53) puede provocar que falle la resolución de nombres, dependiendo de las limitaciones del sistema operativo y de los cortafuegos, si se va a utilizar la función nameserverProtocol() con QDnsLookup::Standard. Cabe destacar que la API de Windows utilizada por QDnsLookup no es capaz de gestionar números de puerto alternativos.

Esta función se introdujo en Qt 6.6.

[since 6.8] QDnsLookup::QDnsLookup(QDnsLookup::Type type, const QString &name, QDnsLookup::Protocol protocol, const QHostAddress &nameserver, quint16 port = 0, QObject *parent = nullptr)

Crea un objeto QDnsLookup para realizar una consulta sobre name del tipo de registro type, utilizando el servidor DNS nameserver que se ejecuta en el puerto port, y establece parent como objeto padre.

La consulta se enviará utilizando protocol, si es compatible. Utiliza isProtocolSupported() para comprobar si es compatible.

Nota: Establecer el número de puerto en cualquier valor distinto del predeterminado (53) puede provocar que falle la resolución de nombres, dependiendo de las limitaciones del sistema operativo y de los cortafuegos, si se utiliza nameserverProtocol() con QDnsLookup::Standard. Cabe destacar que la API de Windows utilizada por QDnsLookup no es capaz de gestionar números de puerto alternativos.

Esta función se introdujo en Qt 6.8.

[virtual noexcept] QDnsLookup::~QDnsLookup()

Elimina el objeto ` QDnsLookup `.

Es seguro eliminar un objeto ` QDnsLookup ` aunque no haya finalizado; simplemente nunca recibirás sus resultados.

[slot] void QDnsLookup::abort()

Cancela la operación de búsqueda DNS.

Si la búsqueda ya ha finalizado, no realiza ninguna acción.

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

Devuelve la lista de registros de nombre canónico asociados a esta consulta.

[static noexcept, since 6.8] quint16 QDnsLookup::defaultPortForProtocol(QDnsLookup::Protocol protocol)

Devuelve el número de puerto estándar (por defecto) para el protocolo protocol.

Esta función se introdujo en Qt 6.8.

Véase también isProtocolSupported().

[signal] void QDnsLookup::finished()

Esta señal se emite cuando ha finalizado el procesamiento de la respuesta.

Nota: Señalde notificación para las propiedades authenticData, error y errorString.

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

Devuelve la lista de registros de direcciones de host asociados a esta consulta.

bool QDnsLookup::isFinished() const

Devuelve si la respuesta ha finalizado o se ha interrumpido.

[static, since 6.8] bool QDnsLookup::isProtocolSupported(QDnsLookup::Protocol protocol)

Devuelve «true» si se admiten las consultas DNS que utilizan « protocol » con « QDnsLookup ».

Esta función se introdujo en Qt 6.8.

Véase también nameserverProtocol.

[slot] void QDnsLookup::lookup()

Realiza la consulta DNS.

Una vez finalizada la operación, se emite la señal « finished()».

QList<QDnsMailExchangeRecord> QDnsLookup::mailExchangeRecords() const

Devuelve la lista de registros de intercambio de correo asociados a esta consulta.

Los registros están ordenados según la norma RFC 5321, por lo que, si los utilizas para conectarte a servidores, debes probarlos en el orden en que aparecen en la lista.

[signal] void QDnsLookup::nameChanged(const QString &name)

Esta señal se emite cuando cambia la entrada de consulta « name ». « name » es el nuevo nombre de la entrada de consulta.

Nota: Señalde notificación para la propiedad name.

QList<QDnsDomainNameRecord> QDnsLookup::nameServerRecords() const

Devuelve la lista de registros de servidores de nombres asociados a esta búsqueda.

QList<QDnsDomainNameRecord> QDnsLookup::pointerRecords() const

Devuelve la lista de registros de punteros asociados a esta búsqueda.

QList<QDnsServiceRecord> QDnsLookup::serviceRecords() const

Devuelve la lista de registros de servicio asociados a esta búsqueda.

Los registros están ordenados según la norma RFC 2782, por lo que, si los utilizas para conectarte a servidores, debes probarlos en el orden en que aparecen en la lista.

[since 6.6] void QDnsLookup::setNameserver(const QHostAddress &nameserver, quint16 port)

Establece el servidor de nombres en nameserver y el puerto en port.

Nota: Establecer el número de puerto en cualquier valor distinto del predeterminado (53) puede provocar que falle la resolución de nombres, dependiendo de las limitaciones del sistema operativo y de los cortafuegos, si se va a utilizar nameserverProtocol() en lugar de QDnsLookup::Standard. Cabe destacar que la API de Windows utilizada por QDnsLookup no es capaz de gestionar números de puerto alternativos.

Nota: Funciónde configuración para la propiedad nameserver.

Esta función se introdujo en Qt 6.6.

Véase también QDnsLookup::nameserver y QDnsLookup::nameserverPort.

[since 6.8] void QDnsLookup::setSslConfiguration(const QSslConfiguration &sslConfiguration)

Establece el servidor de dominios « sslConfiguration » que se utilizará para las conexiones salientes de DNS sobre TLS.

Esta función se introdujo en Qt 6.8.

Véase también sslConfiguration() y QSslSocket::setSslConfiguration().

QSslConfiguration QDnsLookup::sslConfiguration() const

Devuelve la configuración SSL actual.

Véase también setSslConfiguration().

QList<QDnsTextRecord> QDnsLookup::textRecords() const

Devuelve la lista de registros de texto asociados a esta búsqueda.

[since 6.8] QList<QDnsTlsAssociationRecord> QDnsLookup::tlsAssociationRecords() const

Devuelve la lista de registros de asociación TLS asociados a esta consulta.

Según los estándares relativos a la autenticación de entidades con nombre basada en DNS (DANE), este campo debe ignorarse y no debe utilizarse para verificar la autenticidad de un servidor determinado si no es posible confirmar la autenticidad de la respuesta DNS en sí misma. Consulte isAuthenticData() para obtener más información.

Esta función se introdujo en Qt 6.8.

[signal] void QDnsLookup::typeChanged(QDnsLookup::Type type)

Esta señal se emite cuando cambia la consulta type. type es el nuevo tipo de consulta.

Nota: Señalde notificación para la propiedad type.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.