Compartilhar via

estrutura DNS_QUERY_REQUEST3 (windns.h)

  • Artigo

Contém os parâmetros de consulta DNS usados em uma chamada para DnsQueryEx.

Sintaxe

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;

Membros

Version

Tipo: ULONG

A versão da estrutura deve ser a DNS_QUERY_REQUEST_VERSION3; que tem um valor de 3.

QueryName

Tipo: PCWSTR

Um ponteiro para uma cadeia de caracteres que representa o nome DNS a ser consultado.

Observação

Se QueryName for NULL, a consulta será para o nome do computador local.

QueryType

Tipo: WORD

Um valor que representa o Tipo de Registro DNS do Registro de Recurso (RR) que é consultado. QueryType determina o formato dos dados apontados por pQueryRecords retornados na estrutura DNS_QUERY_RESULT . Por exemplo, se o valor de wType for DNS_TYPE_A, o formato dos dados apontados por pQueryRecordsserá DNS_A_DATA.

QueryOptions

Tipo: ULONG64

Um valor que contém um bitmap de Opções de Consulta DNS a ser usado na consulta DNS. As opções podem ser combinadas e todas as opções substituem DNS_QUERY_STANDARD.

pDnsServerList

Tipo: PDNS_ADDR_ARRAY

Um ponteiro para uma estrutura DNS_ADDR_ARRAY que contém uma lista de servidores DNS a serem usados na consulta.

InterfaceIndex

Tipo: ULONG

Um valor que contém o índice de interface sobre o qual a consulta é enviada. Se InterfaceIndex for 0, todas as interfaces serão consideradas.

pQueryCompletionCallback

Tipo: PDNS_QUERY_COMPLETION_ROUTINE

Um ponteiro para um retorno de chamada DNS_QUERY_COMPLETION_ROUTINE usado para retornar os resultados de uma consulta assíncrona de uma chamada para DnsQueryEx.

Observação

Se FOR NULL, DnsQueryEx será chamado de forma síncrona.

pQueryContext

Tipo: PVOID

Um ponteiro para um contexto de usuário.

IsNetworkQueryRequired

Tipo: BOOL

Reservado.

RequiredNetworkIndex

Tipo: DWORD

Reservado.

cCustomServers

Tipo: DWORD

O número de servidores personalizados apontados pelo membro pCustomServers .

pCustomServers

Tipo: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

Um ponteiro para uma matriz de N (em que N é fornecido no campo cCustomServers ) DNS_CUSTOM_SERVER objetos.

Se cCustomServers for 0, pCustomServers deverá ser NULL.

Observação

Pelo menos um dos pCustomServers e pDnsServerList deve ser NULL. Não há suporte para ambos definidos como valores não NULL ao mesmo tempo.

Comentários

Os servidores personalizados especificados em pCustomServers ignoram os servidores DNS configurados pelo sistema.

Se o nome da consulta corresponder a uma regra na NRPT (Tabela de Política de Resolução de Nomes), os servidores personalizados serão ignorados e somente os servidores da regra NRPT serão usados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Build 22000
Servidor mínimo com suporte Windows Build 22000
Cabeçalho windns.h

Confira também