DNS_QUERY_REQUEST struttura (windns.h)

Articolo
08/27/2023

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;

Members

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 è per il nome del computer locale.

QueryType

Valore che rappresenta il tipo di record DNS (RR) di record DNS che viene eseguita una query. QueryType determina il formato dei dati a cui fa riferimento pQueryRecords restituito nella struttura DNS_QUERY_RESULT . Ad esempio, se il valore di wType è DNS_TYPE_A, il formato dei dati a cui fa riferimento 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 contenente 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, tutte le interfacce verranno considerate.

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.