структура DNS_QUERY_RESULT (windns.h)

Статья
01/16/2025

Структура DNS_QUERY_RESULT содержит результаты запроса DNS, возвращаемые из вызова DnsQueryEx.

Синтаксис

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

Члены

Version

Версия структуры должна быть одной из следующих:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Состояние возврата вызова DnsQueryEx.

Если запрос был выполнен асинхронно и эта структура была возвращена непосредственно из DnsQueryEx, QueryStatus содержит DNS_REQUEST_PENDING.

Если запрос был выполнен синхронно или если эта структура была возвращена обратным вызовом DNS DNS_QUERY_COMPLETION_ROUTINE, QueryStatus содержит ERROR_SUCCESS в случае успешного выполнения или соответствующего кода ошибки DNS, как определено в Winerror.h.

QueryOptions

Значение, содержащее растровое изображение параметров запроса DNS, которые использовались в ЗАПРОСе DNS. Параметры можно объединить и переопределить все параметры DNS_QUERY_STANDARD

pQueryRecords

Указатель на структуру DNS_RECORD.

Если запрос был выполнен асинхронно и эта структура была возвращена непосредственно из DnsQueryEx, pQueryRecords имеет значение NULL.

Если запрос был выполнен синхронно или если эта структура была возвращена обратным вызовом DNS DNS_QUERY_COMPLETION_ROUTINE, pQueryRecords содержит список записей ресурсов (RR), составляющих ответ.

Примечание Приложениям должны бесплатно возвращать наборы RR с функцией DnsRecordListFree.

Reserved

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 8 [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2012 [только классические приложения]
заголовка	windns.h

См. также

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST

Поделиться через