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

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

  • Статья

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

Синтаксис

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

Члены

Version

Тип: ULONG

Версия структуры должна быть DNS_QUERY_REQUEST_VERSION3; значение 3.

QueryName

Тип: PCWSTR

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

Заметка

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

QueryType

Тип: WORD

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

QueryOptions

Тип: ULONG64

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

pDnsServerList

Тип: PDNS_ADDR_ARRAY

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

InterfaceIndex

Тип: ULONG

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

pQueryCompletionCallback

Тип: PDNS_QUERY_COMPLETION_ROUTINE

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

Заметка

Если null, DnsQueryEx вызывается синхронно.

pQueryContext

Тип: PVOID

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

IsNetworkQueryRequired

Тип: BOOL

Скрытный.

RequiredNetworkIndex

Тип: DWORD

Скрытный.

cCustomServers

Тип: DWORD

Количество пользовательских серверов, на которые указывает элемент pCustomServers.

pCustomServers

Тип: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

Указатель на массив N (где N указан в поле cCustomServers) DNS_CUSTOM_SERVER объектов.

Если cCustomServers равно 0, pCustomServers должен быть NULL.

Заметка

По крайней мере один из pCustomServers и pDnsServerList должен быть NULL. Оба значения неNULL одновременно не поддерживаются.

Замечания

Пользовательские серверы, указанные в pCustomServers, обойти настроенные системой DNS-серверы.

Если имя запроса соответствует правилу в таблице политики разрешения имен(NRPT), пользовательские серверы игнорируются, а используются только серверы из правила NR PT NRPT.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows Build 22000
минимальный поддерживаемый сервер Windows Build 22000
заголовка windns.h

См. также