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 structure doit être la DNS_QUERY_REQUEST_VERSION3 ; qui a la valeur 3.

QueryName

Type : PCWSTR

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

Notes

Si QueryName a la valeur NULL, la requête concerne le nom de l’ordinateur local.

QueryType

Type : WORD

Valeur qui représente le type d’enregistrement DNS Enregistrement de ressource (RR) interrogé. QueryType détermine le format des données pointées vers les 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 des 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 de 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 a la valeur 0, toutes les interfaces seront prises en compte.

pQueryCompletionCallback

Type : PDNS_QUERY_COMPLETION_ROUTINE

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

Notes

Si la valeur est NULL, DnsQueryEx est appelée de manière 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 a la valeur 0, pCustomServers doit avoir la valeur NULL.

Notes

Au moins l’un des pCustomServers et pDnsServerList doit avoir la valeur NULL. Les deux valeurs définies sur des valeurs non NULL en même temps ne sont pas prises en charge.

Remarques

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

Si le nom de la requête correspond à une règle dans 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 NRPT sont utilisés.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Build 22000
Serveur minimal pris en charge Windows Build 22000
En-tête windns.h

Voir aussi