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 |
- Lista de todos los miembros, incluidos los heredados
- QDnsLookup forma parte de la API de programación de redes.
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
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.
| Constante | Valor | Descripción |
|---|---|---|
QDnsLookup::NoError | 0 | No se ha producido ningún error. |
QDnsLookup::ResolverError | 1 | Se ha producido un error al inicializar el resolutor DNS del sistema. |
QDnsLookup::OperationCancelledError | 2 | La búsqueda se ha abortado mediante el método abort(). |
QDnsLookup::InvalidRequestError | 3 | La consulta DNS solicitada no era válida. |
QDnsLookup::InvalidReplyError | 4 | La respuesta devuelta por el servidor no era válida. |
QDnsLookup::ServerFailureError | 5 | El servidor ha detectado un fallo interno al procesar la solicitud (SERVFAIL). |
QDnsLookup::ServerRefusedError | 6 | El servidor se ha negado a procesar la solicitud por motivos de seguridad o por políticas (REFUSED). |
QDnsLookup::NotFoundError | 7 | El nombre de dominio solicitado no existe (NXDOMAIN). |
QDnsLookup::TimeoutError | 8 | No 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.
| Constante | Valor | Descripción |
|---|---|---|
QDnsLookup::Standard | 0 | DNS normal, sin cifrar, que utiliza UDP y recurre a TCP cuando es necesario (puerto predeterminado: 53) |
QDnsLookup::DnsOverTls | 1 | DNS 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.
| Constante | Valor | Descripción |
|---|---|---|
QDnsLookup::A | 1 | Registros de direcciones IPv4. |
QDnsLookup::AAAA | 28 | Registros de direcciones IPv6. |
QDnsLookup::ANY | 255 | Cualquier registro. |
QDnsLookup::CNAME | 5 | Registros de nombre canónico. |
QDnsLookup::MX | 15 | Registros de intercambio de correo. |
QDnsLookup::NS | 2 | registros de servidor de nombres. |
QDnsLookup::PTR | 12 | registros de puntero. |
QDnsLookup::SRV | 33 | registros de servicio. |
QDnsLookup::TLSA (since Qt 6.8) | 52 | registros de asociación TLS. |
QDnsLookup::TXT | 16 | registros 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.