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.

Nota

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

QueryType

Tipo: WORD

Um valor que representa o registro de recurso (RR) de tipo de registro DNS 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 pQueryRecords será DNS_A_DATA.

QueryOptions

Tipo: ULONG64

Um valor que contém um bitmap de opções de consulta DNS a serem usadas 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 de 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.

Nota

Se 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: DNS_CUSTOM_SERVER* _Field_size_(cCustomServers)

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.

Nota

Pelo menos um dos pCustomServers e pDnsServerList deve ser NULL. Não há suporte para valores de NULL nãoao mesmo tempo.

Observações

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

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

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Build 22000
servidor com suporte mínimo Windows Build 22000
cabeçalho windns.h

Consulte também