Класс QDnsLookup

Класс QDnsLookup представляет поиск DNS. Подробнее...

• Список всех членов, включая наследуемые

Открытые типы

Свойства

Открытые функции

Открытые слоты

Сигналы

Подробное описание

QDnsLookup использует механизмы операционной системы для выполнения запросов DNS. Для выполнения запроса необходимо указать имя имя и тип тип, а затем вызвать слот lookup(). Сигнал finished() будет выпущен по завершении.

Например, вы можете определить, к каким серверам должен подключаться клиент чата XMPP для данного домена:

void MyObject::lookupServers()
{
    // Create a DNS lookup.
    dns = new QDnsLookup(this);
    connect(dns, SIGNAL(finished()),
            this, SLOT(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();
}

Примечание: Если вам просто нужно найти IP-адрес(ы), связанный(е) с именем хоста, или имя хоста, связанный(й) с IP-адресом, используйте QHostInfo.

Документация по типам членов

enum QDnsLookup::Error

Указывает все возможные ошибки, возникшие во время обработки запроса DNS.

enum QDnsLookup::Type

Указывает тип запроса DNS, который был выполнен.

Документация по членам-функциям

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

Создаёт объект QDnsLookup для заданного типа type, имени name и сервера имен nameserver и устанавливает parent как родительский объект.

Эта функция была добавлена в Qt 5.4.

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

Создаёт объект QDnsLookup для заданного типа type и имени name и устанавливает parent как родительский объект.

QDnsLookup::QDnsLookup(QObject *parent = nullptr)

Создаёт объект QDnsLookup и устанавливает parent как родительский объект.

Свойство type будет по умолчанию равно QDnsLookup::A.

[slot] void QDnsLookup::abort()

Прерывает операцию поиска в DNS.

Если поиск уже завершен, ничего не делает.

[signal] void QDnsLookup::finished()

Этот сигнал испускается, когда обработка ответа завершена.

Примечание: Сигнал оповещения для свойства error. Сигнал оповещения для свойства errorString.

[slot] void QDnsLookup::lookup()

Выполняет поиск в DNS.

Сигнал finished() испускается по завершении.

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

Этот сигнал испускается, когда имя поиска name изменяется. name — новое имя для поиска.

Примечание: Сигнал оповещения для свойства name.

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

Этот сигнал испускается, когда тип поиска type изменяется. type — новый тип поиска.

Примечание: Сигнал оповещения для свойства type.

[virtual] QDnsLookup::~QDnsLookup()

Удаляет объект QDnsLookup.

Безопасно удалить объект QDnsLookup, даже если он не завершён; вы просто никогда не получите его результаты.

QList<QDnsDomainNameRecord> QDnsLookup::canonicalNameRecords() const

Возвращает список записей канонических имён, связанных с этим поиском.

QList<QDnsHostAddressRecord> QDnsLookup::hostAddressRecords() const

Возвращает список записей адресов хостов, связанных с этим поиском.

bool QDnsLookup::isFinished() const

Возвращает, завершён ли запрос или был прерван.

QList<QDnsMailExchangeRecord> QDnsLookup::mailExchangeRecords() const

Возвращает список записей MX (Mail Exchange), связанных с этим поиском.

Записи отсортированы в соответствии с RFC 5321, поэтому при подключении к серверам следует использовать их в указанном порядке.

QList<QDnsDomainNameRecord> QDnsLookup::nameServerRecords() const

Возвращает список записей DNS серверов, связанных с этим поиском.

QList<QDnsDomainNameRecord> QDnsLookup::pointerRecords() const

Возвращает список записей указателей (PTR), связанных с этим поиском.

QList<QDnsServiceRecord> QDnsLookup::serviceRecords() const

Возвращает список записей служб (SRV), связанных с этим поиском.

Записи отсортированы в соответствии с RFC 2782, поэтому при подключении к серверам следует использовать их в указанном порядке.

QList<QDnsTextRecord> QDnsLookup::textRecords() const

Возвращает список текстовых записей, связанных с этим поиском.