structure DNS_QUERY_REQUEST (windns.h)
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.
QueryType
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
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
Pointeur vers une structure 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 est 0, toutes les interfaces sont prises en compte.
pQueryCompletionCallback
Pointeur vers un rappel DNS_QUERY_COMPLETION_ROUTINE utilisé pour renvoyer les résultats d’une requête asynchrone à partir d’un appel à DnsQueryEx.
pQueryContext
Pointeur vers un contexte utilisateur.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 8 [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| d’en-tête | windns.h |