structure DNS_QUERY_RESULT (windns.h)

Article
03/04/2024

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 structure doit être l’une des suivantes :

DNS_QUERY_REQUEST_VERSION1 (1)

QueryStatus

Retour status de l’appel à DnsQueryEx.

Si la requête a été terminée de manière asynchrone et que cette structure a été retournée directement à partir de DnsQueryEx, QueryStatus contient DNS_REQUEST_PENDING.

Si la requête a été terminée de manière synchrone ou si cette structure a été retournée par le rappel DNS DNS_QUERY_COMPLETION_ROUTINE , QueryStatus contient ERROR_SUCCESS en cas de réussite ou le code d’erreur dns approprié tel que défini dans Winerror.h.

QueryOptions

Valeur qui contient une bitmap des 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é terminée de manière 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 manière 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.

Note Les applications doivent libérer les jeux RR retournés avec la fonction DnsRecordListFree .

Reserved

Configuration requise

Condition requise	Valeur
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

DNS_QUERY_REQUEST

Partager via