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;

Members

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 tipo di record DNS RR (Resource Record) 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 delle 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 che contiene 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 usato 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: _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

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 di pCustomServers e pDnsServerList deve essere NULL. Entrambi impostati su valori non NULL contemporaneamente non sono supportati.

Commenti

I server personalizzati specificati in pCustomServers ignorano 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 .

Requisiti

Requisito Valore
Client minimo supportato Windows Build 22000
Server minimo supportato Windows Build 22000
Intestazione windns.h

Vedi anche