Partager via

structure DNS_QUERY_REQUEST3 (windns.h)

  • Article

Contient les paramètres de requête DNS utilisés dans un appel à DnsQueryEx.

Syntaxe

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;

Membres

Version

Type : ULONG

La version de la structure doit être la DNS_QUERY_REQUEST_VERSION3; dont la valeur est 3.

QueryName

Type : PCWSTR

Pointeur vers une chaîne qui représente le nom DNS à interroger.

Note

Si nom_requête est NULL, la requête correspond au nom de l’ordinateur local.

QueryType

Type : WORD

Valeur qui représente l’enregistrement de ressource (RR) type d’enregistrement DNS interrogé. QueryType détermine le format des données pointées par pQueryRecords retournés dans la structure DNS_QUERY_RESULT. Par exemple, si la valeur de wType est DNS_TYPE_A, le format des données pointées par pQueryRecords est DNS_A_DATA.

QueryOptions

Type : ULONG64

Valeur qui contient une bitmap de options de requête DNS à utiliser dans la requête DNS. Les options peuvent être combinées et toutes les options remplacent DNS_QUERY_STANDARD.

pDnsServerList

Type : PDNS_ADDR_ARRAY

Pointeur vers une structure DNS_ADDR_ARRAY qui contient une liste de serveurs DNS à utiliser dans la requête.

InterfaceIndex

Type : ULONG

Valeur qui contient l’index d’interface sur lequel la requête est envoyée. Si InterfaceIndex est 0, toutes les interfaces sont prises en compte.

pQueryCompletionCallback

Type : PDNS_QUERY_COMPLETION_ROUTINE

Pointeur vers un rappel DNS_QUERY_COMPLETION_ROUTINE utilisé pour renvoyer les résultats d’une requête asynchrone à partir d’un appel à DnsQueryEx.

Note

Si NULL, DnsQueryEx est appelée de façon synchrone.

pQueryContext

Type : PVOID

Pointeur vers un contexte utilisateur.

IsNetworkQueryRequired

Type : BOOL

Réservé.

RequiredNetworkIndex

Type : DWORD

Réservé.

cCustomServers

Type : DWORD

Nombre de serveurs personnalisés pointés par le membre pCustomServers.

pCustomServers

Type : _Field_size_(cCustomServers) DNS_CUSTOM_SERVER*

Pointeur vers un tableau de N (où N est donné dans le champ cCustomServers) DNS_CUSTOM_SERVER objets.

Si cCustomServers est 0, pCustomServers doit être NULL.

Note

Au moins un des pCustomServers et pDnsServerList doivent être NULL. Les deux valeurs définies sur non-null en même temps ne sont pas prises en charge.

Remarques

Les serveurs personnalisés spécifiés dans pCustomServers contourner les serveurs DNS configurés par le système.

Si le nom de la requête correspond à une règle dans lade la table de stratégie de résolution de noms (NRPT) , les serveurs personnalisés sont ignorés et seuls les serveurs de la règle de NRPT sont utilisés.

Exigences

Exigence Valeur
client minimum pris en charge Windows Build 22000
serveur minimum pris en charge Windows Build 22000
d’en-tête windns.h

Voir aussi