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