estrutura DNS_QUERY_REQUEST (windns.h)

A estrutura DNS_QUERY_REQUEST contém os parâmetros de consulta DNS usados em uma chamada para DnsQueryEx.

Sintaxe

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;

Membros

Version

A versão da estrutura deve ser uma das seguintes:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

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

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

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

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

InterfaceIndex

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

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

Um ponteiro para um contexto de usuário.

Requisitos

   
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Cabeçalho windns.h

Confira também

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx