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

voidMyObject::handleServers()
{
    // 检查查询是否成功。
    if(dns->error()!=QDnsLookup::NoError) {
        qWarning("DNS lookup failed");
        dns->deleteLater();
        return;
    }

    // 处理结果。
    const autorecords= dns->serviceRecords();
    for(constQDnsServiceRecord&record: records) {
        ...
    }
    dns->deleteLater();
}

成员函数文档

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

创建一个 QDnsLookup 对象，并将parent 设置为父对象。

type 属性将默认设置为QDnsLookup::A 。

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

根据给定的type 和name 创建一个QDnsLookup对象，并将parent 设置为父对象。

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

创建一个 QDnsLookup 对象，用于查询记录类型为type 的name ，使用运行在默认 DNS 端口上的 DNS 服务器nameserver ，并将parent 设置为父对象。

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

创建一个 QDnsLookup 对象，用于对记录类型为type 的name 发起查询，使用运行在端口port 上的 DNS 服务器nameserver ，并将parent 设置为父对象。

该函数在 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)

创建一个 QDnsLookup 对象，用于针对记录类型为type 的name 发起查询，使用运行在端口port 上的 DNS 服务器nameserver ，并将parent 设置为父对象。

如果支持，查询将通过protocol 发送。请使用isProtocolSupported() 检查是否支持。

该函数于 Qt 6.8 版本中引入。

[virtual noexcept] QDnsLookup::~QDnsLookup()

销毁QDnsLookup 对象。

即使QDnsLookup 对象尚未完成，删除它也是安全的，只是您将永远无法收到其结果。

[slot] void QDnsLookup::abort()

中止 DNS 查询操作。

如果查询已经完成，则不执行任何操作。

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

返回与该查询相关的规范名称记录列表。

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

返回协议protocol 的标准（默认）端口号。

该函数在 Qt 6.8 中引入。

另请参阅 isProtocolSupported()。

[signal] void QDnsLookup::finished()

当回复处理完成时，会发出此信号。

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

返回与该查询相关的主机地址记录列表。

bool QDnsLookup::isFinished() const

返回回复是否已完成或已被中止。

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

如果QDnsLookup 支持使用protocol 的 DNS 查询，则返回 true。

该函数在 Qt 6.8 中引入。

另请参阅 nameserverProtocol 。

[slot] void QDnsLookup::lookup()

执行 DNS 查询。

完成后将发出finished()信号。

QList<QDnsMailExchangeRecord> QDnsLookup::mailExchangeRecords() const

返回与该查询相关的邮件交换记录列表。

这些记录是按照RFC 5321 进行排序的，因此如果您要使用它们连接到服务器，应按列表中的顺序依次尝试。

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

当查找项name 发生变化时，会发出此信号。name 是新的查找项名称。

QList<QDnsDomainNameRecord> QDnsLookup::nameServerRecords() const

返回与该查询相关的域名服务器记录列表。

QList<QDnsDomainNameRecord> QDnsLookup::pointerRecords() const

返回与该查找操作关联的指针记录列表。

QList<QDnsServiceRecord> QDnsLookup::serviceRecords() const

返回与该查找相关的服务记录列表。

这些记录是按照RFC 2782 进行排序的，因此，如果您要使用它们连接到服务器，应按列表中的顺序依次尝试。

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

将域名服务器设置为nameserver ，端口设置为port 。

该函数于 Qt 6.6 中引入。

另请参阅 QDnsLookup::nameserver 和QDnsLookup::nameserverPort 。

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

设置用于建立出站 DNS-over-TLS 连接的sslConfiguration 。

该函数在 Qt 6.8 中引入。

另请参阅 sslConfiguration() 和QSslSocket::setSslConfiguration()。

QSslConfiguration QDnsLookup::sslConfiguration() const

返回当前的 SSL 配置。

另请参阅 setSslConfiguration()。

QList<QDnsTextRecord> QDnsLookup::textRecords() const

返回与该查找相关的文本记录列表。

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

返回与本次查询相关的 TLS 关联记录列表。

根据与基于 DNS 的命名实体认证（DANE）相关的标准，如果无法确认 DNS 响应本身的真实性，则应忽略此字段，且不得将其用于验证给定服务器的真实性。更多信息请参见isAuthenticData()。

该函数于 Qt 6.8 中引入。

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

当查找项type 发生变化时，会发出此信号。type 是新的查找类型。