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)

デフォルトのDNSポートで動作しているDNSサーバーnameserver を使用して、レコードタイプtype のname に対するクエリを発行するQDnsLookupオブジェクトを作成し、parent を親オブジェクトとして設定します。

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

ポートport で動作している DNS サーバーnameserver を使用して、レコードタイプtype のname に対するクエリを発行する QDnsLookup オブジェクトを構築し、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)

ポートport で動作している DNS サーバーnameserver を使用して、レコードタイプtype のname に対するクエリを発行する QDnsLookup オブジェクトを構築し、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 」は新しいルックアップ型です。