Partager via


structure DNS_QUERY_RESULT (windns.h)

Une structure DNS_QUERY_RESULT contient les résultats de la requête DNS retournés par un appel à DnsQueryEx.

Syntaxe

typedef struct _DNS_QUERY_RESULT {
  ULONG       Version;
  DNS_STATUS  QueryStatus;
  ULONG64     QueryOptions;
  PDNS_RECORD pQueryRecords;
  PVOID       Reserved;
} DNS_QUERY_RESULT, *PDNS_QUERY_RESULT;

Membres

Version

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

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

État de retour de l’appel à DnsQueryEx.

Si la requête a été effectuée de façon asynchrone et que cette structure a été retournée directement à partir de DnsQueryEx, QueryStatus contient DNS_REQUEST_PENDING.

Si la requête a été effectuée de façon synchrone ou si cette structure a été retournée par le rappel DNS DNS_QUERY_COMPLETION_ROUTINE, QueryStatus contient ERROR_SUCCESS si elle réussit ou si le code d’erreur propre au DNS approprié est défini dans Winerror.h.

QueryOptions

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

pQueryRecords

Pointeur vers une structure DNS_RECORD.

Si la requête a été effectuée de façon asynchrone et que cette structure a été retournée directement à partir de DnsQueryEx, pQueryRecords a la valeur NULL.

Si la requête a été effectuée de façon synchrone ou si cette structure a été retournée par le rappel DNS DNS_QUERY_COMPLETION_ROUTINE, pQueryRecords contient une liste d’enregistrements de ressources (RR) qui composent la réponse.

Remarque Applications doivent libérer les jeux RR retournés avec la fonction DnsRecordListFree.
 

Reserved

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

Voir aussi

DNS_QUERY_CANCEL

DNS_QUERY_COMPLETION_ROUTINE

DNS_QUERY_REQUEST