Condividi tramite

struttura DNS_QUERY_REQUEST3 (windns.h)

  • Articolo

Contiene i parametri di query DNS usati in una chiamata a DnsQueryEx.

Sintassi

typedef struct _DNS_QUERY_REQUEST3 {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
  BOOL                          IsNetworkQueryRequired;
  DWORD                         RequiredNetworkIndex;
  DWORD                         cCustomServers;
  DNS_CUSTOM_SERVER             *pCustomServers;
} DNS_QUERY_REQUEST3, *PDNS_QUERY_REQUEST3;

Membri

Version

Tipo: ULONG

La versione della struttura deve essere la DNS_QUERY_REQUEST_VERSION3; che ha un valore pari a 3.

QueryName

Tipo: PCWSTR

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

Tipo: WORD

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

Tipo: ULONG64

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

Tipo: PDNS_ADDR_ARRAY

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

InterfaceIndex

Tipo: ULONG

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

pQueryCompletionCallback

Tipo: PDNS_QUERY_COMPLETION_ROUTINE

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

Tipo: PVOID

Puntatore a un contesto utente.

IsNetworkQueryRequired

Tipo: BOOL

Riservato.

RequiredNetworkIndex

Tipo: DWORD

Riservato.

cCustomServers

Tipo: DWORD

Numero di server personalizzati a cui punta il membro pCustomServers.

pCustomServers

Tipo: DNS_CUSTOM_SERVER* _Field_size_(cCustomServers)

Puntatore a una matrice di N (dove N viene specificato nel campo cCustomServers) DNS_CUSTOM_SERVER oggetti.

Se cCustomServers è 0, pCustomServers deve essere NULL.

Nota

Almeno uno dei pCustomServers e pDnsServerList deve essere NULL. Entrambi impostati su valori null non contemporaneamente non sono supportati.

Osservazioni

I server personalizzati specificati in pCustomServers ignorare i server DNS configurati dal sistema.

Se il nome della query corrisponde a una regola nella tabella dei criteri di risoluzione dei nomi (NRPT), i server personalizzati vengono ignorati e vengono usati solo i server della regola NRPT.

Fabbisogno

Requisito Valore
client minimo supportato Windows Build 22000
server minimo supportato Windows Build 22000
intestazione windns.h

Vedere anche