struttura DNS_QUERY_RESULT (windns.h)

Articolo
01/16/2025

Una struttura DNS_QUERY_RESULT contiene i risultati della query DNS restituiti da una chiamata a DnsQueryEx.

Sintassi

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

Membri

Version

La versione della struttura deve essere una delle seguenti:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Stato restituito della chiamata a DnsQueryEx.

Se la query è stata completata in modo asincrono e questa struttura è stata restituita direttamente da DnsQueryEx, QueryStatus contiene DNS_REQUEST_PENDING.

Se la query è stata completata in modo sincrono o se questa struttura è stata restituita dal callback DNS DNS_QUERY_COMPLETION_ROUTINE, QueryStatus contiene ERROR_SUCCESS se ha esito positivo o il codice di errore specifico del DNS appropriato, come definito in Winerror.h.

QueryOptions

Valore che contiene una bitmap di opzioni di query DNS usate nella query DNS. Le opzioni possono essere combinate e tutte le opzioni sostituiscono DNS_QUERY_STANDARD

pQueryRecords

Puntatore a una struttura DNS_RECORD.

Se la query è stata completata in modo asincrono e questa struttura è stata restituita direttamente da DnsQueryEx, pQueryRecords è NULL.

Se la query è stata completata in modo sincrono o se questa struttura è stata restituita dal callback DNS DNS_QUERY_COMPLETION_ROUTINE, pQueryRecords contiene un elenco di record di risorse (RR) che costituiscono la risposta.

Nota Le applicazioni devono liberare set RR restituiti con la funzione DnsRecordListFree.

Reserved