QDnsLookup 类

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()
{
    // Check the lookup succeeded.
    if (dns->error() != QDnsLookup::NoError) {
        qWarning("DNS lookup failed");
        dns->deleteLater();
        return;
    }

    // Handle the results.
    const auto records = dns->serviceRecords();
    for (const QDnsServiceRecord &record : records) {
        ...
    }
    dns->deleteLater();
}

成员函数文档

[显式构造函数] 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)

构造一个用于对 name 进行记录类型 type 的查询的 QDnsLookup 对象，使用运行在默认 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中引入的。

[virtual noexcept] QDnsLookup::~QDnsLookup()

销毁QDnsLookup对象。

即使对象未完成，也可以安全地删除一个QDnsLookup对象，你将永远不会收到其结果。

[slot] void QDnsLookup::abort()

终止DNS查找操作。

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

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

返回与此次查找相关的规范名称记录列表。

[signal] void QDnsLookup::finished()

当响应完成处理时发出此信号。

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

返回与此次查找相关的地址记录列表。

bool QDnsLookup::isFinished() const

返回响应是否已完成或被终止。

[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 排序，因此如果你使用它们连接到服务器，你应该按照列出的顺序尝试它们。

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

将名称服务器设置为 nameserver 并将端口设置为 port。

此函数是在Qt 6.6中引入的。

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

QList<QDnsTextRecord> QDnsLookup::textRecords() const

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

[信号] void QDnsLookup::typeChanged(QDnsLookup::Type type)

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