struttura DNS_QUERY_REQUEST3 (windns.h)
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 |