estrutura DNS_QUERY_RESULT (windns.h)

Artigo
03/04/2024

Uma estrutura DNS_QUERY_RESULT contém os resultados da consulta DNS retornados de uma chamada para DnsQueryEx.

Sintaxe

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

Membros

Version

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

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

O retorno status da chamada para DnsQueryEx.

Se a consulta foi concluída de forma assíncrona e essa estrutura foi retornada diretamente de DnsQueryEx, QueryStatus contém DNS_REQUEST_PENDING.

Se a consulta foi concluída de forma síncrona ou se essa estrutura foi retornada pelo retorno de chamada DNS DNS_QUERY_COMPLETION_ROUTINE , QueryStatus conterá ERROR_SUCCESS se tiver êxito ou o código de erro específico de DNS apropriado, conforme definido em Winerror.h.

QueryOptions

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

pQueryRecords

Um ponteiro para uma estrutura DNS_RECORD .

Se a consulta foi concluída de forma assíncrona e essa estrutura foi retornada diretamente de DnsQueryEx, pQueryRecords será NULL.

Se a consulta foi concluída de forma síncrona ou se essa estrutura foi retornada pelo retorno de chamada DNS DNS_QUERY_COMPLETION_ROUTINE , pQueryRecords contém uma lista de Registros de Recursos (RR) que compõem a resposta.

Nota Os aplicativos devem liberar conjuntos de RR retornados com a função DnsRecordListFree .

Reserved

Requisitos

Requisito	Valor
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_REQUEST

Compartilhar via