estrutura DNS_QUERY_RESULT (windns.h)

Artigo
01/16/2025

Uma estrutura de 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 status de retorno 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 DNS_QUERY_COMPLETION_ROUTINE retorno de chamada DNS, QueryStatus contém ERROR_SUCCESS se bem-sucedido 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 é NULL.

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

Observação Aplicativos devem liberar conjuntos de RR retornados com a função DnsRecordListFree .

Reserved

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_REQUEST

Partilhar via