struttura DNS_QUERY_REQUEST (windns.h)

Articolo
11/08/2024

La struttura DNS_QUERY_REQUEST contiene i parametri di query DNS usati in una chiamata a DnsQueryEx.

Sintassi

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;

Membri

Version

La versione della struttura deve essere una delle seguenti:

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

Puntatore a una stringa che rappresenta il nome DNS da eseguire per la query.

Nota Se QueryName è NULL, la query è relativa al nome del computer locale.

QueryType

Valore che rappresenta il record di risorse (RR) tipo di record DNS su cui viene eseguita una query. QueryType determina il formato dei dati a cui punta pQueryRecords restituiti nella struttura DNS_QUERY_RESULT. Ad esempio, se il valore di wType è DNS_TYPE_A, il formato dei dati a cui punta pQueryRecords è DNS_A_DATA.

QueryOptions

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

pDnsServerList

Puntatore a una struttura DNS_ADDR_ARRAY che contiene un elenco di server DNS da usare nella query.

InterfaceIndex

Valore contenente l'indice dell'interfaccia su cui viene inviata la query. Se InterfaceIndex è 0, verranno considerate tutte le interfacce.

pQueryCompletionCallback

Puntatore a un callback DNS_QUERY_COMPLETION_ROUTINE utilizzato per restituire i risultati di una query asincrona da una chiamata a DnsQueryEx.

Nota Se NULL, DnsQueryEx viene chiamato in modo sincrono.

pQueryContext

Puntatore a un contesto utente.