structure DNS_QUERY_REQUEST (windns.h)

Article
08/27/2023

La structure DNS_QUERY_REQUEST contient les paramètres de requête DNS utilisés dans un appel à DnsQueryEx.

Syntaxe

typedef struct _DNS_QUERY_REQUEST {
  ULONG                         Version;
  PCWSTR                        QueryName;
  WORD                          QueryType;
  ULONG64                       QueryOptions;
  PDNS_ADDR_ARRAY               pDnsServerList;
  ULONG                         InterfaceIndex;
  PDNS_QUERY_COMPLETION_ROUTINE pQueryCompletionCallback;
  PVOID                         pQueryContext;
} DNS_QUERY_REQUEST, *PDNS_QUERY_REQUEST;

Membres

Version

La version de la structure doit être l’une des suivantes :

DNS_QUERY_REQUEST_VERSION1 (1)

QueryName

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

Note Si QueryName a la valeur NULL, la requête est destinée au nom de l’ordinateur local.

QueryType

Valeur qui représente le type d’enregistrement DNS d’enregistrement RR (Resource Record) 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

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 peuvent être remplacées DNS_QUERY_STANDARD

pDnsServerList

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

InterfaceIndex

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

pQueryCompletionCallback

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

Note Si la valeur est NULL, DnsQueryEx est appelé de manière synchrone.

pQueryContext

Pointeur vers un contexte utilisateur.

Configuration requise


Client minimal pris en charge	Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau uniquement]
En-tête	windns.h

Voir aussi

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

Partager via