estrutura DNS_QUERY_REQUEST (windns.h)

Artigo
11/08/2024

A estrutura de 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.

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

QueryType

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

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

Um ponteiro para uma estrutura de 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.

Observação Se NULL, DnsQueryEx é chamado de forma síncrona.

pQueryContext

Um ponteiro para um contexto de usuário.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8 [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2012 [somente aplicativos da área de trabalho]
cabeçalho	windns.h

Consulte também

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_RESULT

DnsCancelQuery

DnsQuery

DnsQueryEx

Compartilhar via