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

[bindable] nameserver : QHostAddress

注意： 此特性支持 QProperty 绑定。

此特性保持用于 DNS 查找的名称服务器。

[bindable, since 6.6] nameserverPort : quint16

注意： 此特性支持 QProperty 绑定。

This property holds the port number of nameserver to use for DNS lookup.

The value of 0 indicates that QDnsLookup should use the default port for the nameserverProtocol ().

注意： Setting the port number to any value other than the default (53) can cause the name resolution to fail, depending on the operating system limitations and firewalls, if the nameserverProtocol () to be used QDnsLookup::Standard . Notably, the Windows API used by QDnsLookup is unable to handle alternate port numbers.

该特性在 Qt 6.6 引入。

[bindable, since 6.8] nameserverProtocol : Protocol

注意： 此特性支持 QProperty 绑定。

This property holds the protocol to use when sending the DNS query

该特性在 Qt 6.8 引入。

另请参阅 isProtocolSupported ().

[bindable] type : 类型

注意： 此特性支持 QProperty 绑定。

此特性保持 DNS 查找的类型。

成员函数文档编制

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

构造 QDnsLookup 对象并设置 parent 作为父级对象。

The type 特性默认为 QDnsLookup::A .

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

构造 QDnsLookup 对象为给定 type and name 并设置 parent 作为父级对象。

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

Constructs a QDnsLookup object to issue a query for name of record type type , using the DNS server nameserver running on the default DNS port, and sets parent 作为父级对象。

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

Constructs a QDnsLookup object to issue a query for name of record type type , using the DNS server nameserver running on port port , and sets parent 作为父级对象。

注意： Setting the port number to any value other than the default (53) can cause the name resolution to fail, depending on the operating system limitations and firewalls, if the nameserverProtocol () to be used QDnsLookup::Standard . Notably, the Windows API used by QDnsLookup is unable to handle alternate port numbers.

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

Constructs a QDnsLookup object to issue a query for name of record type type , using the DNS server nameserver running on port port , and sets parent 作为父级对象。

The query will be sent using protocol , if supported. Use isProtocolSupported () to check if it is supported.

注意： Setting the port number to any value other than the default (53) can cause the name resolution to fail, depending on the operating system limitations and firewalls, if the nameserverProtocol () to be used QDnsLookup::Standard . Notably, the Windows API used by QDnsLookup is unable to handle alternate port numbers.

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

Returns the standard (default) port number for the protocol protocol .

该函数在 Qt 6.8 引入。

另请参阅 isProtocolSupported ().

[signal] void QDnsLookup:: finished ()

此信号被发射，当回复已处理完成。

注意： 通知程序信号对于特性 authenticData , error ，和 errorString .

QList < QDnsHostAddressRecord > QDnsLookup:: hostAddressRecords () const

返回关联此查找的主机地址记录列表。

bool QDnsLookup:: isFinished () const

返回回复是已完成还是被中止。

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

Returns true if DNS queries using protocol are supported with QDnsLookup .

该函数在 Qt 6.8 引入。

另请参阅 nameserverProtocol .

[slot] void QDnsLookup:: lookup ()

履行 DNS 查找。

The finished () signal is emitted upon completion.

QList < QDnsMailExchangeRecord > QDnsLookup:: mailExchangeRecords () const

返回关联此查找的邮件交换记录列表。

记录的排序是根据 RFC 5321 ，因此，若使用它们连接到服务器，应按照列表它们的次序尝试。

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

此信号发射，当查找 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 )

Sets the nameserver to nameserver and the port to port .

注意： Setting the port number to any value other than the default (53) can cause the name resolution to fail, depending on the operating system limitations and firewalls, if the nameserverProtocol () to be used QDnsLookup::Standard . Notably, the Windows API used by QDnsLookup is unable to handle alternate port numbers.

注意： setter 函数对于特性 nameserver .

该函数在 Qt 6.6 引入。

另请参阅 QDnsLookup::nameserver and QDnsLookup::nameserverPort .

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

设置 sslConfiguration to use for outgoing DNS-over-TLS connections.

该函数在 Qt 6.8 引入。

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

QSslConfiguration QDnsLookup:: sslConfiguration () const

Returns the current SSL configuration.

另请参阅 setSslConfiguration ().

QList < QDnsTextRecord > QDnsLookup:: textRecords () const

返回关联此查找的文本记录列表。

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

Returns the list of TLS association records associated with this lookup.

According to the standards relating to DNS-based Authentication of Named Entities (DANE), this field should be ignored and must not be used for verifying the authentity of a given server if the authenticity of the DNS reply cannot itself be confirmed. See isAuthenticData () 了解更多信息。

该函数在 Qt 6.8 引入。

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

此信号发射，当查找 type 改变。 type 是新的查找类型。

注意： 通知程序信号对于特性 type .