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

Статья
11/08/2024

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

Синтаксис

typedef struct _DNS_QUERY_REQUEST {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
} DNS_QUERY_REQUEST, *PDNS_QUERY_REQUEST;

Члены

Version

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

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

Указатель на строку, представляющую DNS-имя для запроса.

Примечание Если имя запроса имеет значение NULL, запрос предназначен для имени локального компьютера.

QueryType

Значение, представляющее тип записи DNS, который запрашивается. QueryType определяет формат данных, на который указывает pQueryRecords, возвращенный в структуре DNS_QUERY_RESULT. Например, если значение wTypeDNS_TYPE_A, формат данных, указывающийся на pQueryRecords, DNS_A_DATA.

QueryOptions

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

pDnsServerList

Указатель на структуру DNS_ADDR_ARRAY, содержащую список DNS-серверов, используемых в запросе.

InterfaceIndex

Значение, содержащее индекс интерфейса, по которому отправляется запрос. Если InterfaceIndex равно 0, все интерфейсы будут рассматриваться.

pQueryCompletionCallback

Указатель на обратный вызов DNS_QUERY_COMPLETION_ROUTINE, используемый для возврата результатов асинхронного запроса из вызова DnsQueryEx.

Примечание Если значение NULL, DnsQueryEx вызывается синхронно.

pQueryContext

Указатель на контекст пользователя.

Требования

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

См. также

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

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