QDnsLookup Class

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();
}

void MyObject::handleServers()
{
    // Vérifier que la recherche a abouti.
    if (dns->error() != QDnsLookup::NoError) {
        qWarning("DNS lookup failed");
        dns->deleteLater();
        return;
    }

    // Traiter les résultats.
    const auto records = dns->serviceRecords();
    for (const QDnsServiceRecord&record: records) {
        ...
    }
    dns->deleteLater();
}

Documentation des fonctions membres

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

Crée un objet QDnsLookup et définit parent comme objet parent.

La propriété type prendra par défaut la valeur QDnsLookup::A.

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

Crée un objet QDnsLookup pour les valeurs « type » et « name » fournies, et définit « parent » comme objet parent.

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

Crée un objet QDnsLookup afin d'effectuer une requête sur name pour le type d'enregistrement type, en utilisant le serveur DNS nameserver fonctionnant sur le port DNS par défaut, et définit parent comme objet parent.

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

Crée un objet QDnsLookup pour lancer une requête concernant l'adresse name de type d'enregistrement type, en utilisant le serveur DNS nameserver fonctionnant sur le port port, et définit parent comme objet parent.

Cette fonction a été introduite dans 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)

Crée un objet QDnsLookup afin d'effectuer une requête sur name pour le type d'enregistrement type, en utilisant le serveur DNS nameserver fonctionnant sur le port port, et définit parent comme objet parent.

La requête sera envoyée via protocol, si cette méthode est prise en charge. Utilisez isProtocolSupported() pour vérifier si elle est prise en charge.

Cette fonction a été introduite dans Qt 6.8.

[virtual noexcept] QDnsLookup::~QDnsLookup()

Supprime l'objet ` QDnsLookup `.

Vous pouvez supprimer un objet ` QDnsLookup ` en toute sécurité, même s'il n'a pas encore terminé son exécution ; vous ne recevrez tout simplement jamais ses résultats.

[slot] void QDnsLookup::abort()

Interrompt l'opération de recherche DNS.

Si la recherche est déjà terminée, ne fait rien.

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

Renvoie la liste des enregistrements de nom canonique associés à cette recherche.

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

Renvoie le numéro de port standard (par défaut) du protocole protocol.

Cette fonction a été introduite dans Qt 6.8.

Voir également ` isProtocolSupported()`.

[signal] void QDnsLookup::finished()

Ce signal est émis lorsque le traitement de la réponse est terminé.

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

Renvoie la liste des enregistrements d'adresses hôtes associés à cette recherche.

bool QDnsLookup::isFinished() const

Indique si la réponse s'est terminée ou si elle a été interrompue.

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

Renvoie « true » si les requêtes DNS utilisant « protocol » sont prises en charge avec « QDnsLookup ».

Cette fonction a été introduite dans Qt 6.8.

Voir aussi nameserverProtocol.

[slot] void QDnsLookup::lookup()

Effectue la recherche DNS.

Le signal « finished() » est émis une fois l'opération terminée.

QList<QDnsMailExchangeRecord> QDnsLookup::mailExchangeRecords() const

Renvoie la liste des enregistrements d'échange de courrier associés à cette recherche.

Ces enregistrements sont triés conformément à la norme RFC 5321; par conséquent, si vous les utilisez pour vous connecter à des serveurs, vous devez les essayer dans l'ordre dans lequel ils sont répertoriés.

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

Ce signal est émis lorsque l'name de la table de correspondance change. « name » est le nouveau nom de la table de correspondance.

QList<QDnsDomainNameRecord> QDnsLookup::nameServerRecords() const

Renvoie la liste des enregistrements de serveurs de noms associés à cette recherche.

QList<QDnsDomainNameRecord> QDnsLookup::pointerRecords() const

Renvoie la liste des enregistrements de pointeurs associés à cette recherche.

QList<QDnsServiceRecord> QDnsLookup::serviceRecords() const

Renvoie la liste des enregistrements de service associés à cette recherche.

Les enregistrements sont triés conformément à la norme RFC 2782; par conséquent, si vous les utilisez pour vous connecter à des serveurs, vous devez les essayer dans l'ordre dans lequel ils sont répertoriés.

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

Définit le serveur de noms sur nameserver et le port sur port.

Cette fonction a été introduite dans Qt 6.6.

Voir également QDnsLookup::nameserver et QDnsLookup::nameserverPort.

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

Définit l'sslConfiguration e à utiliser pour les connexions DNS-over-TLS sortantes.

Cette fonction a été introduite dans Qt 6.8.

Voir également ` sslConfiguration()` et ` QSslSocket::setSslConfiguration()`.

QSslConfiguration QDnsLookup::sslConfiguration() const

Renvoie la configuration SSL actuelle.

Voir également la fonction ` setSslConfiguration()`.

QList<QDnsTextRecord> QDnsLookup::textRecords() const

Renvoie la liste des enregistrements de texte associés à cette recherche.

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

Renvoie la liste des enregistrements d'association TLS associés à cette requête.

Conformément aux normes relatives à l’authentification des entités nommées basée sur le DNS (DANE), ce champ doit être ignoré et ne doit pas être utilisé pour vérifier l’authenticité d’un serveur donné si l’authenticité de la réponse DNS ne peut pas être confirmée. Voir isAuthenticData() pour plus d’informations.

Cette fonction a été introduite dans Qt 6.8.

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

Ce signal est émis lorsque l'type de la recherche change. type correspond au nouveau type de recherche.